使用Node.js14部署React项目至GAE标准环境时遇错误码13

问题背景 #

此前6个月内，将React项目通过gcloud部署至GAE标准环境（Node.js14 runtime）均正常，未修改package.json与app.yaml，但近期部署突然触发错误码13（内部错误）。已尝试更新gcloud SDK至436.0.0、更新应用服务账号等操作，使用gcloud app deploy --verbosity=debug --log-http部署仍失败。

当前app.yaml配置：

runtime: nodejs14
env: standard
instance_class: F1
handlers:
  - url: /(.*\..+)$
    static_files: build/\1
    upload: build/(.*\..+)$
  - url: /.*
    static_files: build/index.html
    upload: build/index.html
  - url: .*
    script: auto
automatic_scaling:
  min_idle_instances: automatic
  max_idle_instances: automatic
  min_pending_latency: automatic
  max_pending_latency: automatic
service_account: xxxxxxxx@appspot.gserviceaccount.com

部署日志关键报错：

DEBUG: (gcloud.app.deploy) Error Response: [13] An internal error occurred.

解决方案 #

1. 升级Node.js runtime版本 #

Node.js14已结束官方生命周期（EOL），GAE后台可能已调整对其的支持策略，这是导致突发部署失败的常见原因：

• 修改app.yaml中的runtime字段为nodejs16或nodejs18（推荐LTS版本）
• 同步升级本地开发环境的Node.js版本，重新安装依赖并构建项目：

  rm -rf node_modules build
  npm install
  npm run build
  

2. 清理部署缓存并重新构建 #

本地或gcloud缓存损坏可能引发部署异常：

• 清理gcloud本地缓存：

  gcloud cache delete
  

• 重新部署时禁用缓存：

  gcloud app deploy --no-cache --verbosity=debug
  

3. 修复app.yaml配置冲突 #

当前handlers规则存在冗余和匹配冲突：

• 第二个规则url: /.*已覆盖所有非静态文件请求，第三个url: .*规则永远不会被触发，且script: auto对纯静态React项目无意义，删除后调整为：

  handlers:
    - url: /(.*\..+)$
      static_files: build/\1
      upload: build/(.*\..+)$
    - url: /.*
      static_files: build/index.html
      upload: build/index.html
  

4. 验证服务账号权限 #

确保指定的服务账号拥有足够的部署权限：

• 检查服务账号现有角色：

  gcloud projects get-iam-policy [你的项目ID] --filter="bindings.members:serviceAccount:xxxxxxx@appspot.gserviceaccount.com" --format="table(bindings.role)"
  

• 若缺少权限，添加App Engine Deployer和Cloud Build Editor角色：

  gcloud projects add-iam-policy-binding [你的项目ID] --member=serviceAccount:xxxxxxx@appspot.gserviceaccount.com --role=roles/appengine.deployer
  gcloud projects add-iam-policy-binding [你的项目ID] --member=serviceAccount:xxxxxxx@appspot.gserviceaccount.com --role=roles/cloudbuild.builds.editor
  

5. 查看Cloud Build详细日志 #

GAE部署依赖Cloud Build，内部错误可能源于构建环节：

• 进入Google Cloud Console → Cloud Build → 历史记录，找到对应部署任务的构建日志，排查是否存在依赖安装失败、构建命令报错等具体问题。

6. 指定全新版本号部署 #

尝试跳过旧版本冲突，指定新的版本号部署：

gcloud app deploy --version=v20230628-custom --verbosity=debug

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