Google Cloud部署Node.js WebSocket应用遇就绪检查失败503错误求助

问题核心 #

部署基于WebSocket的Node.js应用到Google Cloud App Engine后，出现503 Service Unavailable错误，日志提示实例未通过就绪检查。已添加/_ah/health就绪检查路由和对应app.yaml配置，但部署后该路径仍无法访问，本地运行正常。

具体修复步骤 #

1. 补全缺失的依赖与代码 #

你的代码中使用了favicon中间件，但未引入对应的模块，部署时会导致启动失败：

• 在server.js顶部添加模块引入：

  const favicon = require('serve-favicon');
  

• 在package.json的dependencies中添加依赖：

  "serve-favicon": "^2.5.0"
  

2. 正确配置端口 #

App Engine会通过环境变量PORT分配端口，不能使用未定义的port变量：
修改server.listen部分的代码：

const port = process.env.PORT || 8080;
server.listen(port, () => {
    console.log(`Server is running on port ${port}`);
});

3. 补全app.yaml的必要配置 #

你的app.yaml缺少运行时声明和WebSocket必需的会话亲和性配置，完整配置示例：

runtime: nodejs20 # 根据你的Node.js版本调整，如nodejs18、nodejs20
service: default

readiness_check:
  path: "/_ah/health"
  check_interval_sec: 5
  timeout_sec: 4
  failure_threshold: 2
  success_threshold: 2
  app_start_timeout_sec: 300

# 开启WebSocket会话粘性，确保连接稳定
network:
  session_affinity: true

4. 验证就绪检查与日志排查 #

• 部署后用curl测试就绪路径：

  curl https://你的项目ID.uc.r.appspot.com/_ah/health
  

• 登录Google Cloud控制台，进入Cloud Logging，过滤App Engine实例的启动日志，查看是否有模块缺失、端口绑定失败等报错，这些是导致就绪检查不通过的常见原因。

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