私有Cloud9工作区Websockets请求出现502错误求助

DevOps 小满

2026-5-20

解决Cloud9环境下WebSocket连接502错误的实用方案

我之前在Cloud9上调试WebSocket服务时也碰到过一模一样的502问题，折腾了好一阵才搞定，给你几个针对性的排查方向：

务必使用Cloud9提供的预览域名连接
Cloud9的工作区不是直接暴露公网IP的，必须通过它生成的预览URL访问。客户端要连接的是wss://<workspace-name>-<your-username>.c9users.io这种格式的地址（注意是wss不是ws，因为Cloud9预览走HTTPS，WebSocket要对应加密协议），直接用IP加端口肯定会报502。
服务端必须绑定到0.0.0.0
别把WebSocket服务绑定到localhost或者127.0.0.1，Cloud9的外部请求无法访问本地回环地址。以Node.js为例，服务端代码要改成这样：
```
const WebSocket = require('ws');
const wss = new WebSocket.Server({ port: 8080, host: '0.0.0.0' });
```
其他语言同理，确保监听地址是0.0.0.0而不是本地地址。
检查服务是否正常监听端口
在Cloud9终端里执行netstat -tulpn | grep <你的端口号>，确认服务确实在监听指定端口。如果没找到进程，说明服务没启动或者启动失败，先把服务跑起来再说。
反向代理的WebSocket配置（如果用到的话）
如果你在Cloud9里用了Nginx之类的反向代理，必须配置WebSocket的协议升级支持，否则代理会把WebSocket请求当成普通HTTP请求处理，导致502。示例Nginx配置：
```
location /ws {
    proxy_pass http://0.0.0.0:8080;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}
```
这段配置告诉代理要识别WebSocket的升级请求，转发给后端服务。
临时关闭客户端证书验证（仅开发测试用）
Cloud9的预览域名用的是共享SSL证书，部分严格的客户端会因为证书不信任拒绝连接，虽然这通常报的是SSL错误，但偶尔也会间接导致502。可以在客户端临时关闭证书验证，比如Node.js客户端：
```
const ws = new WebSocket('wss://your-cloud9-preview-url', { rejectUnauthorized: false });
```
上线前记得改回来就行。