Angular 8与angular-recaptcha3依赖冲突致.NET Core+Angular项目构建失败

1. 还原原开发者的依赖环境 #

原项目能正常构建，说明存在可工作的依赖状态，优先还原这个状态：

• 检查项目根目录是否有package-lock.json或yarn.lock文件，不要删除，直接执行：

  npm ci
  

  这个命令会严格按照lock文件安装依赖，避免npm自动解析版本导致的冲突，是还原依赖最可靠的方式。
• 如果没有lock文件，找原开发者要他们本地的package-lock.json，或者让他们提供npm list的输出，拿到精确的依赖版本树。

2. 定位冲突根源并针对性修复 #

如果无法拿到原lock文件，尝试以下方式：

• 降级angular-recaptcha3到兼容Angular 8的版本：你之前换版本无效，可能是没找对兼容的分支。查angular-recaptcha3的版本历史，找明确标注支持Angular 8的1.x系列版本，执行：

  npm uninstall angular-recaptcha3
  npm install angular-recaptcha3@1.x --save
  

  安装后执行npm ls @angular/common检查是否还有peer依赖警告。
• 用--legacy-peer-deps临时绕过冲突：如果只是构建阶段的警告不影响功能，可在安装依赖时添加参数：

  npm install --legacy-peer-deps
  

  这个参数会回到npm v6的依赖解析逻辑，忽略peer依赖冲突，适合旧项目临时构建。注意：这是临时方案，长期还是要对齐版本。

3. 逐步统一Angular版本（若必须升级） #

如果一定要升级Angular版本，不能直接跳级到10，要按官方步骤逐步升级：

• 先从Angular 8升级到9：

  ng update @angular/core@8 @angular/cli@8
  ng update @angular/core@9 @angular/cli@9
  

• 再从9升级到10：

  ng update @angular/core@10 @angular/cli@10
  

  每一步升级后都要解决当前的依赖冲突，比如同步升级angular-recaptcha3到对应支持版本，避免一次性跳级引发大量冲突。

4. 调整.NET Core构建的npm触发逻辑 #

确认dotnet publish是否自动执行了npm install，如果是，修改项目的.csproj文件，指定用npm ci替代npm install，保证依赖安装的一致性：
找到类似节点，修改为：

<Target Name="PublishRunWebpack" AfterTargets="ComputeFilesToPublish">
  <Exec Command="npm ci" />
  <Exec Command="npm run build -- --prod" />
</Target>

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