CircleCI CI/CD流水线无法执行npm run脚本命令问题求助

必做调试前置步骤 #

先在config.yml的aws-cli/setup步骤之后，所有业务run步骤之前新增调试步骤，确认基础环境正确性：

- run:
    name: 环境校验
    command: |
      # 打印当前工作目录，确认位于项目根目录
      pwd
      # 打印当前目录文件列表，确认根目录package.json存在
      ls -la
      # 打印npm版本，确认符合项目要求
      npm -v
      # 打印npm可识别的所有脚本，确认根目录scripts被正确加载
      npm run

问题修复方案 #

方案1：替换cd切换目录写法为npm官方prefix参数 #

你当前根目录package.json的脚本用cd切换目录的写法，在部分shell环境和npm版本下会出现上下文丢失问题，建议替换为npm原生的--prefix参数指定工作目录，兼容性更强：

{
    "scripts": {
        "frontend:install": "npm install --prefix ./client",
        "backend:install": "npm install --prefix ./server",
        "frontend:build": "npm run build --prefix ./client",
        "backend:build": "npm run build --prefix ./server",
        "frontend:deploy": "npm run deploy --prefix ./client",
        "backend:deploy": "npm run deploy --prefix ./server"
    }
}

方案2：显式指定Node版本匹配项目要求 #

你的server目录package.json明确要求Node版本>=14.17.1、npm版本>=6.14.13，CircleCI默认安装的Node版本可能不符合要求，修改config.yml的node安装步骤指定版本：

- node/install:
    node-version: '14.17.1'

方案3：检查.gitignore配置 #

确认项目根目录的.gitignore文件没有排除package.json文件，避免CircleCI拉取代码后根目录缺失package.json，导致npm无法读取scripts配置。

方案4：拆分命令显式切换目录 #

如果还是出现报错，可以直接在config.yml的步骤中显式切换目录执行命令，跳过根目录脚本的中转：

- run:
    name: Front-End Build
    command: |
      cd client
      npm run build

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