Google Cloud Build莫名执行npm run build致Node.js部署失败求助

原因 #

Google App Engine的Node.js运行时近期调整了自动构建逻辑：当检测到你的package.json中存在build脚本时，Cloud Build会自动触发npm run build步骤——哪怕你没有上传构建所需的源码文件，这就是导致部署失败的核心原因。

解决办法 #

你可以通过以下两种方式解决：

1. 移除package.json中的build脚本 #

如果你的项目已经提前完成构建（部署的是dist目录下的产物），不需要在部署阶段执行构建，直接删除package.json里的build脚本条目即可。比如把类似下面的内容删掉：

"scripts": {
  "build": "xxx", // 删掉这一行
  "cloud-start": "xxx"
}

2. 自定义Cloud Build流程，跳过构建步骤 #

创建一个cloudbuild.yaml文件放在项目根目录，自定义部署时的构建流程，只执行依赖安装（如果需要），不触发build：

steps:
- name: 'gcr.io/cloud-builders/npm'
  args: ['install', '--production']
# 这里不添加npm run build的步骤

之后部署时，App Engine会自动使用这个自定义构建配置，不会再执行默认的npm run build。

额外检查 #

确认你的.cloudignore配置没有问题——当前配置已经正确排除了源码文件，只保留了package.json、package-lock.json和dist目录，这部分不需要修改。

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