移动端H5 WebSocket连不上主因是协议不合规、代理配置缺失或隐私模式限制：必须用受信CA签发的wss://（禁用ws://和自签名证书），Nginx需配全proxy_http_version 1.1、Upgrade与Connection头，隐私模式下应避免localStorage依赖并改用URL传参鉴权。
移动端H5里WebSocket连不上，八成不是代码写错了，而是被网络、协议或浏览器策略卡住了。 真机上失败但PC端正常，基本可以排除业务逻辑问题，重点查WSS、代理、隐私模式和降级路径。
为什么wss://在手机浏览器里直接报错或静默失败
绝大多数移动端H5 WebSocket失败，根源是协议不合规：H5环境强制要求使用wss://（而非ws://），且证书必须有效、可被系统信任。iOS Safari 和 Android Chrome 对非标准端口（如:8080、:9001）的wss连接会直接拒绝，哪怕证书没问题。
- 检查URL是否硬编码了
ws://——必须改成wss://，哪怕本地开发也建议用反向代理统一走443 - 自签名证书在手机上几乎必然失败；Let’s Encrypt等公开CA签发的证书才可能被信任
- 部分安卓厂商定制浏览器（如华为、小米内置浏览器）会拦截未备案域名的
wss请求，即使HTTPS正常 - 不要依赖
location.port拼接URL，移动端可能返回""或443导致地址错误
nginx反向代理WebSocket必须配对的三行头
如果后端WebSocket服务跑在非443端口（比如http://localhost:7001），又不想改服务端，就必须用nginx做wss → http桥接。漏掉任意一行，手机端就会卡在connecting状态不动。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
-
proxy_http_version 1.1：必须显式声明，否则默认HTTP/1.0不支持Upgrade -
proxy_set_header Upgrade $http_upgrade：把客户端的Upgrade: websocket头透传过去 -
proxy_set_header Connection "upgrade"：注意是字面量"upgrade"，不是变量$connection_upgrade（后者需额外map块定义，容易漏） - 补充：加上
proxy_read_timeout 300，避免移动网络抖动触发意外断连
隐私模式下WebSocket完全没反应怎么办
Chrome无痕、Safari私密窗口里new WebSocket(...)可能既不触发onopen也不触发onerror，Network面板里连握手请求都看不到——这不是Bug，是浏览器主动限制。
- 别从
localStorage读取token或endpoint：隐私模式下访问localStorage会抛SecurityError，导致后续构造WebSocket被跳过 - 把鉴权参数放到URL里更稳妥，例如
wss://api.example.com/ws?token=xxx，服务端在升级前解析校验 - 检测隐私模式：用
!window.indexedDB或!window.localStorage粗略判断，失败后提示用户“请切换至普通窗口”比盲目重试更友好 - 真要降级，优先选
EventSource（SSE），它比轮询省资源，且兼容性更好（iOS 5.0+、Android 4.4+）
旧版Android WebView或UC浏览器需要兜底方案
Android 4.4以下WebView、部分国产浏览器内核（如早期QQ浏览器X5）根本不支持WebSocket构造函数，typeof WebSocket === 'undefined'为true。
- 别只用
try/catch——得先if (typeof WebSocket !== 'function')再走降级逻辑 -
SockJS仍是目前最轻量可靠的Polyfill，CDN引入即可：<script src="https://cdn.jsdelivr.net/npm/sockjs-client@1/dist/sockjs.min.js"></script> - 注意
SockJS服务端必须配套（如sockjs-node），且URL不能带wss://前缀，应为https://domain.com/sockjs这类路径 - 某些场景下，用
XMLHttpRequest长轮询比SockJS更可控，尤其当后端不配合改造时
真正麻烦的从来不是“怎么连上”，而是“连不上时怎么知道是哪一环断了”。手机端没有Network面板实时看握手，就得靠console.log打点、setTimeout兜底超时、以及服务端日志交叉验证。别假设“连不上=后端挂了”。
