如何解决Angular NX项目中的NG0203错误？

问题概述 #

• 项目在Windows系统（Node.js 18.19）可正常启动，但在Intel芯片Mac（macOS 13.6.3）及2016款Mac上运行时触发NG0203错误
• 错误提示：

Error: NG0203: inject() must be called from an injection context such as a constructor, a factory function, a field initializer, or a function used with runInInjectionContext

• 已尝试的无效操作：
  • 升级/降级Angular（16.2）和NX（17.2）版本
  • 复制同事的node_modules目录
  • 检查服务端口占用
  • 通过NVM切换Node.js 16/18版本（其他Angular项目运行正常）
  • 更换浏览器测试
  • 确认项目配置和依赖与同事完全一致

针对性修复方案 #

1. 彻底清理缓存并重新构建 #

macOS下缓存残留容易引发依赖或构建异常，执行以下命令：

npm cache clean --force
npx nx reset
rm -rf node_modules package-lock.json
npm ci
npx nx build [你的项目名称]

2. 排查第三方依赖的平台兼容性 #

部分npm包可能存在平台特异性问题：

• 检查package.json中近期新增的依赖，尝试临时移除后重新运行，定位是否为特定包导致
• 查看依赖的官方文档，确认是否需要在macOS下额外配置环境变量或依赖

3. 规范inject()调用场景 #

macOS下的Angular运行时可能对注入规则检测更严格：

• 确保所有inject()调用仅出现在构造函数、工厂函数、字段初始化器中
• 若需在异步回调或普通函数中使用依赖，用runInInjectionContext包裹：

  import { inject, runInInjectionContext, Injector } from '@angular/core';
  
  const injector = inject(Injector);
  runInInjectionContext(injector, () => {
    // 在这里调用inject()或使用依赖
  });
  

4. 调整NX构建配置 #

检查项目的project.json构建配置：

• 禁用增量构建，添加"incremental": false到targets.build.options中
• 确认outputPath等路径配置无macOS权限问题（避免写入受保护目录）

内容的提问来源于stack exchange，提问作者menethil