The upgrade guide does not cover `ng update` stopping on a Node.js version message
维护者通常 3 天内回复
评估
- 难度
- 1/5
- 预计耗时
- 1 小时以内
- 新手友好度
- 92/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
调研方向
打开 docs/version-21-upgrade.md，并结合报告中的 ng update 命令和 Node.js 输出阅读现有的“Other notes”部分。添加一则简洁说明，涵盖令人困惑的消息、临时使用最新 CLI 导致该消息的原因，以及文档中说明的解决方法；完成标准是 Angular 21 升级指南涵盖这一场景，同时不更改 AngularFire 代码。
由索引模型根据 Issue 内容生成。
描述
In an app that is already on Angular 21, ng update @angular/fire@next can stop before it updates anything:
Installing a temporary Angular CLI versioned latest to perform the update.
Node.js version v22.22.1 detected.
The Angular CLI requires a minimum Node.js version of v22.22.3 or v24.15.0 or v26.0.0.
Node.js 22.22.1 is a version Angular 21 supports, so the message is confusing, and docs/version-21-upgrade.md does not mention it.
Why it happens
ng updatechooses which Angular CLI runs the update from the first@angular/package in the command. If that package has no version number, it downloads@angular/cli@latest.@angular/cli@latestis 22.2.1, which requires Node.js^22.22.3 || ^24.15.0 || >=26.0.0. Angular CLI 21 accepts^20.19.0 || ^22.12.0 || >=24.0.0.- On a Node.js version in between, the downloaded CLI refuses to start. This is Angular CLI behavior, and it happens before any AngularFire code runs.
What I ran
On Node.js 22.22.1, on 2026-10-02:
ng update @angular/fireandng update @angular/fire@nextin an Angular 21 app both stop with the message above.ng update @angular/[email protected]in the same app does not.- The guide's own command,
ng update @angular/core@21 @angular/cli@21 @angular/fire@next, is not affected. It ran with a temporary Angular CLI 21.2.24 and completed.
Proposed change
A bullet under "Other notes" naming the message, the cause, and the two ways past it: update Node.js, or give the first @angular/ package a version number.
- 主要语言
- TypeScript
- 星标
- 7.8k
- 派生
- 2.2k
- 平均合并
- 2 天 14 小时
- 30 天内合并 PR
- 19
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
angular/angularfire 的其他 Issue
-
Use `TransferState` to hand server-rendered Firestore data to the browser, instead of reading every document twice可能重新可做 @armando-navarro 于 43 天前认领，目前没有进行中的 PR。 未关闭comp: firestore comp: ssr priority: P0 (critical) type: feature version: current (v17+)
angular/angularfire#3757 · 已指派 1 人 ·
维护者通常 3 天内回复
-
Six `firebase` entry points have no `@angular/fire` equivalent, so their exports are unreachable可能重新可做 @armando-navarro 于 43 天前认领，目前没有进行中的 PR。 未关闭comp: core type: feature
angular/angularfire#3755 · 已指派 1 人 ·
维护者通常 3 天内回复
-
难度 4/5 3-5 天 新手友好度 35/100
angular/angularfire#3737 · 2 条评论 · 24 个 reaction ·
维护者通常 3 天内回复
-
难度 4/5 3-5 天 新手友好度 52/100
angular/angularfire#3715 ·
维护者通常 3 天内回复
-
comp: build/pipeline type: RFC / discussion / question
难度 5/5 一周以上 新手友好度 25/100
angular/angularfire#3699 · 17 条评论 · 4 个 reaction ·
维护者通常 3 天内回复
查看 angular/angularfire 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 82/100
维护者通常 1 天内回复
-
status:approved type:bug
难度 1/5 1 小时以内 新手友好度 70/100
维护者通常 1 天内回复
-
stage:4
难度 2/5 1-3 小时 新手友好度 65/100
ilan-pinto/roaring-lions#598 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
Frontmatter next to `src:` is applied to every imported slide, not only the first (undocumented)未关闭
难度 2/5 1-3 小时 新手友好度 62/100
维护者通常 1 天内回复