使用AWS Codebuild编译Vue.js项目构建阶段失败问题咨询

错误1：sudo命令不存在报错 #

• 原因：AWS CodeBuild官方提供的标准构建镜像默认以root用户执行所有命令，且大多数镜像未预装sudo工具，直接调用sudo会返回exit status 127的找不到命令错误。
• 修复方案：直接删除所有命令前的sudo前缀即可，无需额外提权。

错误2：vue-cli-service 权限不足报错（exit status 126） #

• 原因：两种常见触发场景：
  1. 本地代码仓提交了node_modules目录到远程，拉取到构建环境后文件执行权限丢失
  2. 构建环境安装依赖后，node_modules/.bin下的可执行文件未被赋予执行权限
• 修复方案：
  1. 建议在.gitignore中排除node_modules目录，不要提交到代码仓，由构建阶段统一安装依赖
  2. 安装依赖后新增权限授予命令，或者直接用npx调用构建命令

修复后的buildspec.yml参考配置 #

version: 0.2

phases:
  install:
    commands:
      # 可选：指定Node版本，避免镜像默认版本和项目不兼容
      # - n 16
      - echo Install Dependencies Phase
      # 清理旧的依赖文件，避免缓存冲突
      - rm -rf node_modules package-lock.json yarn.lock
      - npm install
      # 给可执行文件加执行权限，解决权限报错
      - chmod -R +x node_modules/.bin
  build:
    commands:
      - echo Build Phase
      - npm run build
      # 也可以直接用npx调用避免权限问题：npx vue-cli-service build
  post_build:
    commands:
      - echo PostBuild Phase
      - aws s3 sync ./dist $S3_BUCKET

额外可选优化 #

• 如果依赖安装速度慢，可以开启CodeBuild的缓存功能，缓存node_modules目录，减少构建时间
• 提前确认构建镜像的Node.js版本和项目本地开发用的Node版本一致，避免兼容性报错

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