Angular 7项目Azure DevOps至AWS S3的CI/CD构建失败排查

1. 匹配Node.js版本 #

Angular 7要求使用Node.js 10.x版本（配套npm 6.x），Azure DevOps默认代理可能搭载了不兼容的Node版本，需手动指定：

• 在流水线中添加Node版本安装步骤：

  - task: NodeTool@0
    inputs:
      versionSpec: '10.x'
    displayName: 'Install Node.js 10.x'
  

2. 规范依赖与CLI调用 #

避免全局安装Angular CLI导致版本不兼容，直接使用项目本地CLI执行构建：

• 先完整安装项目依赖：

  - script: npm install
    displayName: 'Install npm dependencies'
  

• 用本地CLI执行构建（参数和本地保持一致，比如添加--prod启用生产环境优化）：

  - script: npx ng build --prod
    displayName: 'Build Angular project'
  

3. 确保仓库文件完整性 #

• 必须提交package-lock.json（或yarn.lock）到仓库，避免流水线拉取依赖时版本不一致。
• 禁止移除package.json，这是项目依赖的核心配置文件，缺失会直接导致构建失败。

4. 优化缓存与权限 #

• 添加缓存步骤加速依赖安装，同时避免缓存污染：

  - task: Cache@2
    inputs:
      key: 'npm | "$(Agent.OS)" | package-lock.json'
      restoreKeys: |
        npm | "$(Agent.OS)"
      path: $(npm_config_cache)
    displayName: 'Cache npm dependencies'
  

• 若遇到权限报错，安装依赖时添加权限参数：

  - script: npm install --unsafe-perm
    displayName: 'Install npm dependencies with permissions'
  

5. 对齐本地构建环境 #

• 流水线的构建命令必须和本地执行的完全一致，包括环境变量、构建配置参数等，比如本地用ng build --configuration=staging，流水线也要同步该参数。
• 检查angular.json中的自定义配置，确保流水线环境能正确读取这些配置项。

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