Google Cloud App Engine上uWebSockets.js服务WebSocket连接报502错误问询

首先修正客户端连接的协议误用 #

你当前编写的WebSocket连接代码存在明显的格式错误，这也是触发问题的核心诱因之一：

• 错误写法：var ws = new WebSocket('https://[PROJECT_ID].ts.r.appspot.com');
• WebSocket连接无法复用HTTP/HTTPS的协议头，对应线上HTTPS域名的服务场景，客户端必须使用加密WebSocket的wss://作为连接前缀。App Engine本身原生支持对HTTPS域名的WebSocket协议升级请求转发，不需要手动额外配置代理规则，平台不会自动把发往HTTPS路径的请求识别为WebSocket连接。
• 正确连接代码示例：var ws = new WebSocket('wss://[PROJECT_ID].ts.r.appspot.com');

502 错误的服务端常见根因 #

502 是 App Engine 前置负载均衡器判定后端服务无有效响应时返回的网关错误，本地运行正常的情况下，触发这类错误的原因基本都是部署配置不符合平台运行规则：

• 端口绑定不匹配：本地开发时你可能习惯把uWebSockets.js的监听端口硬编码为3000、8080这类固定值，但App Engine运行时会通过process.env.PORT环境变量动态分配服务监听端口，如果你没有读取该环境变量指定的端口完成绑定，负载均衡器根本无法访问到你的服务进程，会直接返回502。
• 网卡绑定范围错误：服务端不能仅绑定本地回环地址127.0.0.1，必须绑定0.0.0.0全网卡地址，否则容器内部的流量转发链路无法将平台请求送达你的服务进程。

补充排查方向 #

• 检查项目根目录的app.yaml配置，确认没有配置全量静态路由规则拦截所有请求，导致WebSocket的协议升级请求根本无法抵达你的uWebSockets服务
• 确认服务的健康检查接口可以正常响应：App Engine在正式路由业务流量前会周期性调用健康检查接口，如果接口响应不达标，会直接触发502错误
• 留意平台连接规则：App Engine标准环境对WebSocket连接有60秒的空闲超时限制，即使连接建立成功，无心跳保活的长连接也会被平台主动切断，需要在客户端和服务端配置定时心跳包维持连接活性

本地环境运行正常仅代表业务逻辑没有问题，不代表服务的运行参数符合云平台的容器化部署要求，不需要额外搭建中间代理转发WebSocket流量，修正上述配置即可正常建立长连接。

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