GCP App Engine部署后Socket连接失败（400错误）求助

安全阿岳

2026-6-17

解决方案：GCP App Engine部署Socket.io后WebSocket 400错误

一、针对App Engine Standard环境的修复步骤

修正app.yaml配置
Standard环境下需明确指定支持的Node.js版本，并开启会话亲和性以保证WebSocket连接绑定到同一实例：
```
runtime: nodejs20
env: standard
service: your-service-name # 补全服务名称，不可留空
network:
  session_affinity: true
```
注：Standard环境无需runtime_config字段，直接通过runtime指定版本即可。

调整Socket.io配置

替换cors.origin中的占位符为实际部署域名（如https://your-app-id.uc.r.appspot.com）

显式声明WebSocket路径，避免路由冲突：

const io = new Server(httpServer, {
  cors: {
    origin: ["http://localhost:3001", "https://your-real-deployed-domain.com"],
    methods: ["GET", "POST"],
    credentials: true,
  },
  transports: ["websocket"],
  path: "/socket.io/", // 与客户端请求路径保持一致
});

确保服务器监听正确端口
App Engine通过PORT环境变量分配端口，服务器代码需适配此配置：

const httpServer = require('http').createServer(app);
const port = process.env.PORT || 3000;
httpServer.listen(port, () => {
  console.log(`Server running on port ${port}`);
});

二、解决App Engine Flex环境的部署错误

你遇到的Flex环境部署报错是因为Node.js版本过旧，修正runtime字段即可：

runtime: nodejs20 # 指定官方支持的Node.js版本
env: flex
service: your-service-name
manual_scaling:
  instances: 1
network:
  session_affinity: true

三、客户端连接注意事项

确保客户端使用完整的WSS路径，并与服务端配置匹配：

// 客户端代码示例
import { io } from "socket.io-client";
const socket = io("https://your-real-deployed-domain.com", {
  transports: ["websocket"],
  path: "/socket.io/",
});