升级Node.js至20.15.1后，gcloud app deploy构建步骤2失败

问题背景 #

近期将Node.js版本从4.x升级至20.15.1，配置如下：

• package.json中引擎字段：

"engines": {
    "node": "20.15.1"
  },

• app.yaml配置：

runtime: nodejs
env: flex

此前部署正常，现在执行gcloud app deploy时，构建步骤2失败，报错：

ERROR: build step 2 "gcr.io/kaniko-project/executor@sha256:f87c11770a4d3ed33436508d206c584812cd656e6ed08eda1cff5c1ee44f5870" failed: step exited with non-zero status: 1

解决方法 #

1. 明确指定运行时版本 #

App Engine Flex的nodejs runtime默认可能无法自动匹配高版本Node.js，需在app.yaml中添加runtime_config字段指定版本，避免构建时版本不兼容：

runtime: nodejs
env: flex
runtime_config:
  nodejs_version: 20.15.1

2. 重置依赖锁文件 #

升级Node.js后，旧锁文件可能包含不兼容的依赖版本：

• 删除package-lock.json（或yarn.lock）和node_modules文件夹
• 重新执行npm install（或yarn install）生成新锁文件后再部署

3. 排查依赖兼容性 #

部分旧依赖可能不支持Node.js 20，执行以下命令检查：

npm audit
npx check-node-version --node 20.15.1

替换或更新不兼容的依赖至支持Node.js 20的版本。

4. 获取详细构建日志 #

默认报错信息不足，通过调试模式查看更多细节：

gcloud app deploy --verbosity=debug

根据日志定位具体失败原因（如依赖安装失败、脚本执行错误等）。

5. 确认环境版本支持 #

若20.15.1版本未被App Engine Flex官方支持，可尝试降级至最近的LTS版本（如20.14.0）后重新部署。

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