PHP游戏网站WebSocket连接失败核心是握手未走通：需确认前端为HTTPS、反向代理透传Upgrade/Connection头、后端监听0.0.0.0、响应101且无输出污染、WAF及防火墙放行。
PHP 游戏网站 WebSocket 连接失败，核心问题几乎都出在“握手没走通”，而不是游戏逻辑或 PHP 业务代码本身。重点不是查 new WebSocket() 写得对不对，而是看浏览器发出去的 HTTP Upgrade 请求是否完整抵达后端、服务端是否返回了干净的 101 Switching Protocols 响应。
确认前端页面运行在 HTTPS 环境下
这是最容易被忽略的第一步。现代浏览器禁止从 http:// 页面发起 wss:// 连接——哪怕后端证书完全正确，也会被直接拦截（混合内容策略），控制台报错类似 Mixed Content: The page at 'http://...' was loaded over HTTP, but requested an insecure WebSocket endpoint 'wss://...'。
- 打开浏览器地址栏，确认协议是
https://，且锁图标为绿色（表示证书有效） - 如果用的是本地开发环境（如
http://localhost），请改用ws://测试，或为本地域名配置自签名证书 + 信任（不推荐长期用于游戏上线） - Apache/Nginx 需配置强制 HTTPS 重定向，避免用户误访问 HTTP 版本
检查反向代理是否透传 WebSocket 升级头
绝大多数 PHP 游戏网站部署在 Apache 或 Nginx 后，WebSocket 流量必须经由它们代理到后端（如 Swoole、Workerman 或 Node.js 进程）。若代理层未显式转发关键头，握手请求会在第一关就被“静默截断”。
- Nginx 必须在对应
location块中包含三行（缺一不可）：proxy_http_version 1.1;proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade"; - Apache 使用
mod_proxy_wstunnel，需启用并配置：ProxyPass /ws ws://127.0.0.1:9501/wsProxyPassReverse /ws ws://127.0.0.1:9501/ws - 禁用所有缓存（
proxy_cache off;），WebSocket 握手响应绝不允许缓存
验证后端服务是否真正就绪
PHP 游戏后端若基于 Swoole/Workerman 实现，常见问题不是“连不上”，而是“看似连上实则没握手成功”。
立即学习“PHP免费学习笔记（深入）”；
- 确认服务监听地址是
0.0.0.0:9501（而非仅127.0.0.1:9501），否则代理无法转发 - 用
telnet your-domain.com 443或curl -v -H "Upgrade: websocket" -H "Connection: upgrade" https://your-domain.com/ws直接测试握手是否能拿到101响应 - 检查 Swoole 启动日志是否有
listening on 0.0.0.0:9501；若只显示127.0.0.1，需修改bind配置 - 确保未开启 PHP 的
output_buffering或输出 BOM，任何额外字符都会污染响应头，导致浏览器静默关闭连接
排除 WAF 和防火墙干扰
游戏网站常接入阿里云 WAF、腾讯云 Web 应用防火墙或 Cloudflare，它们默认把 Upgrade: websocket 当作可疑行为拦截，且不返回明确错误（静默 403 或直接丢包）。
- 临时将域名解析指向源站 IP（绕过 WAF），再测试 WebSocket 是否恢复；若恢复，即确认是 WAF 拦截
- 登录 WAF 控制台，添加放行规则：匹配路径（如
/game/ws）+ 请求头Upgrade: websocket→ 动作设为“放行”，并关闭关联的 CC 防护、正则防护 - 检查服务器防火墙（
ufw或firewalld）及云厂商安全组，确保目标端口（如 443 或自定义 wss 端口）已开放 TCP 入站
