AWS Amplify托管的Nuxt应用nuxt generate出错时构建未失败

核心原因 #

• --fail-on-error参数未正确传递给nuxt generate命令：npm运行自定义脚本时，需要使用--作为分隔符，才能把后续参数传递给脚本对应的执行程序，你当前的写法中参数被npm本身接收，没有作用到nuxt命令上。
• Nuxt.js默认行为：旧版本Nuxt.js即使生成过程出现错误，也会返回退出码0，导致AWS Amplify判定构建成功，继续部署损坏的站点。

修复步骤 #

1. 修正构建命令传参 #

将build阶段的generate命令修改为如下格式，确保参数正确传递给nuxt：

build:
  commands:
    - npm run generate -- --fail-on-error

2. 增加构建产物校验（推荐） #

为了避免极端场景下命令返回0但产物损坏的问题，可在generate命令后增加产物校验逻辑，主动触发构建失败：

build:
  commands:
    - npm run generate -- --fail-on-error
    # 校验dist目录是否存在且不为空
    - if [ ! -d "./dist" ] || [ -z "$(ls -A ./dist)" ]; then echo "构建产物异常，终止部署"; exit 1; fi

3. 前置错误校验（可选） #

可在preBuild阶段增加语法检查逻辑，提前捕获代码中的JavaScript错误，避免执行到生成阶段才发现问题：

preBuild:
  commands:
    - npm install
    - echo "API_URL=$API_URL" >> .env 
    # 示例：使用eslint检查代码语法错误，有错误直接退出
    - npx eslint . --ext .js,.vue --quiet

验证方法 #

修改配置后可主动提交一段带有明显JS错误的代码测试，此时构建会被标记为失败，不会部署损坏的站点。

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