AWS CodePipeline配置npm install执行失败求助（COMMAND_EXECUTION_ERROR）

问题描述 #

配置S3存储桶与GitHub账号创建AWS CodePipeline流水线时，Build阶段执行npm install报错：

COMMAND_EXECUTION_ERROR: Error while executing command: npm i. Reason: exit status 1

当前使用的BuildSpec配置如下：

version: 0.2

env:
    variables:
        CACHE_CONTROL: "86400"
        S3_BUCKET: "{{s3_bucket_url}}"
        BUILD_FOLDER: "dist"
phases:
  install:
    runtime-versions:
        nodejs: 16
    commands:
        - echo Installing source NPM dependencies...
        - npm install
        - npm install -g @angular/cli
  build:
    commands:
        - echo Build started 
        - ng build
artifacts:
    files:
        - '**/*'
    base-directory: 'dist*'
    discard-paths: yes

排查步骤与解决方案 #

1. 查看完整错误日志 #

CodePipeline默认只展示精简日志，需到CloudWatch Logs中找到对应构建任务的完整日志，定位npm install失败的具体原因——比如依赖版本冲突、网络不通、权限不足、私有包认证失败等。

2. 检查Node.js与npm版本兼容性 #

当前指定Node.js 16，需确认项目package.json中依赖的npm版本是否与Node.js 16兼容。可在BuildSpec的install阶段添加版本检查命令：

- node --version
- npm --version

若版本不匹配，手动指定兼容的npm版本：

- npm install -g npm@<具体兼容版本号>

3. 优化依赖安装逻辑 #

• 避免全局安装Angular CLI引发的冲突，把@angular/cli加入项目devDependencies，用npx ng build执行构建，修改后的BuildSpec关键部分：

  install:
    runtime-versions:
        nodejs: 16
    commands:
        - echo Installing source NPM dependencies...
        - npm install
  build:
    commands:
        - echo Build started 
        - npx ng build
  

• 若项目支持，可替换npm install为yarn install，部分场景下依赖安装更稳定。

4. 解决网络与权限问题 #

• 若依赖包含私有npm包，需在BuildSpec中添加认证信息（敏感信息用AWS Secrets Manager存储，不要硬编码）：

  - npm config set //registry.npmjs.org/:_authToken $NPM_TOKEN
  

  其中NPM_TOKEN需在CodeBuild项目的环境变量中配置（从Secrets Manager获取）。
• 检查CodeBuild服务角色权限：如果使用VPC，需配置NAT网关或允许出站访问npm registry。

5. 清理缓存重试 #

在BuildSpec中添加缓存清理命令，避免缓存导致的依赖异常：

- npm cache clean --force
- rm -rf node_modules package-lock.json
- npm install

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