CircleCI构建Angular应用至AWS S3失败问题求助

1. 对齐Node.js/NPM版本 #

本地能正常构建但CircleCI失败，首先检查环境版本一致性：

• 本地执行node -v和npm -v，获取当前使用的版本
• 在CircleCI的config.yml中指定相同版本的Node镜像，例如：

jobs:
  build-deploy:
    docker:
      - image: circleci/node:18.17.0 # 替换为你本地的Node版本

2. 确保依赖安装完整 #

CircleCI的缓存可能导致依赖缺失，调整配置保证依赖正确安装：

steps:
  - checkout
  - restore_cache:
      keys:
        - npm-deps-{{ checksum "package-lock.json" }}
        - npm-deps-
  - run: npm install
  - save_cache:
      paths:
        - node_modules
      key: npm-deps-{{ checksum "package-lock.json" }}

• 若怀疑缓存问题，可临时移除restore_cache和save_cache步骤，强制重新安装所有依赖

3. 定位ng build的具体错误 #

查看CircleCI日志中npm run frontend:build的报错信息：

• 若为TypeScript编译错误：检查CircleCI拉取的代码分支是否与本地一致，是否有未提交的代码修改
• 若为内存不足：在构建命令中增加Node内存参数：

run:
  command: npm run frontend:build
  environment:
    NODE_OPTIONS: "--max-old-space-size=4096"

4. 验证构建脚本配置 #

确认package.json中的frontend:build脚本与本地一致，确保输出目录为www：

"scripts": {
  "frontend:build": "ng build --output-path=www"
}

• 检查是否包含--prod、--configuration=production等参数，确认这些参数在CircleCI环境下可正常执行

5. 检查AWS权限配置 #

虽然本地CLI正常，但CircleCI的AWS凭证可能存在问题：

• 确认CircleCI项目环境变量中已配置AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY，且该账号拥有s3:PutObject、s3:ListBucket等必要权限
• 可在部署步骤前添加测试命令aws s3 ls your-bucket-name，验证权限是否正常

6. 确认构建产物路径 #

在构建步骤后添加目录检查命令，确认www目录生成正确：

run: ls -la www

• 确保部署命令（如aws s3 sync www/ s3://your-bucket-name/）指向的路径与实际生成的目录一致

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