环境与兼容条件：现象 → 原因 → 方案
从可观察现象出发，解释底层机制，再给出分层解决方案与验证方法。
页面一直转圈，无法加载
常见于浏览器缓存异常或网络防火墙拦截。WebSocket 连接被阻断时，WhatsApp 网页版会停留在加载状态。
实时通信依赖长连接
WhatsApp 网页版通过 wss:// 协议维持与服务器的长连接。若网络环境禁止非标准端口或代理过滤，连接会失败。
分层排查与修复
① 硬刷新（Ctrl+Shift+R）清除缓存；② 关闭 VPN 或更换网络节点；③ 检查防火墙/安全软件是否拦截 web.whatsapp.com；④ 使用 Chrome 无痕模式验证扩展冲突。
确认连接状态
按 F12 打开开发者工具 → Network 标签，筛选 WS 类型。若看到状态 101 Switching Protocols，说明连接成功；否则检查请求头与代理设置。
| 设备/环境 | 兼容性 | 关键条件 | 验证方式 |
|---|---|---|---|
| Windows / macOS | ✅ 良好 | Chrome, Edge, Firefox 最新版 | 扫码后查看手机端“已链接设备” |
| Linux | ✅ 支持 | 需 Chromium 内核浏览器 | 检查 WebSocket 连接 |
| 平板 (iPadOS) | ⚠️ 部分 | 需使用“桌面版网站”模式 | 切换后重新加载 |
| 手机浏览器 | ❌ 不推荐 | 官方仅支持移动端 App | 页面会提示下载应用 |
为什么 WhatsApp 网页版对“环境”如此敏感？
WhatsApp 网页版并不是一个独立的客户端，而是手机 App 的镜像。它通过扫描二维码与手机建立加密通道，所有消息实际由手机收发。因此，网页版的工作依赖三个核心条件：手机保持在线、浏览器能访问 WhatsApp 服务器、账号未被注销。
设备差异的底层机制
桌面浏览器拥有完整的存储和后台能力，所以官方推荐使用 Chrome 或 Edge。而平板设备（如 iPad）默认使用移动端 User-Agent，服务器会返回移动端页面，导致无法配对。此时需要手动请求桌面站点，本质是改变 User-Agent 让服务器返回桌面版资源。
网络状态：不仅仅是“通不通”
即使网络可以打开普通网页，WebSocket 长连接也可能被限制。某些公共 Wi-Fi 或企业防火墙会过滤非 HTTP/HTTPS 流量，而 WhatsApp 网页版使用的 wss:// 协议在握手阶段与 HTTPS 相同，但后续帧格式不同。部分安全软件会误判为异常流量。验证方法：在开发者工具的 Console 中执行 window.WebSocket，若返回 undefined 则说明浏览器禁用了 WebSocket。
账号状态边界
网页版不会主动登出，但手机端若切换账号、删除应用或超过 14 天未使用，链接会失效。这是安全机制：二维码本质上是一次性令牌，绑定后手机与浏览器保持心跳。如果手机长时间断网，网页版会显示“正在等待网络连接”。
不同设备、浏览器、网络与账号状态下的差异
为什么我的 iPhone 扫码后网页版一直显示“正在连接”？
iOS 上 Safari 浏览器的“智能防跟踪”可能阻止跨站请求。请尝试使用 Chrome 浏览器，并在手机端确认 WhatsApp 通知权限已开启。若仍无效，关闭 Wi-Fi 使用蜂窝数据测试，排除路由器对 WebSocket 的干扰。
在 Firefox 上无法使用 WhatsApp 网页版，是浏览器问题吗？
Firefox 需要开启“严格跟踪保护”的例外。WhatsApp 网页版依赖第三方 Cookie 维持会话。在地址栏点击盾牌图标，选择“关闭跟踪保护”后重新加载。此外，Firefox 的增强跟踪保护默认会隔离站点数据，导致扫码状态丢失。
公司网络下无法连接，但手机热点可以，原因是什么？
企业防火墙通常只开放 80/443 端口，但可能对 WebSocket 的 Upgrade 头进行过滤。热点网络通常无此限制。可尝试在浏览器地址栏输入 chrome://net-internals/#sockets 查看连接状态，或联系网络管理员放行 web.whatsapp.com 的 wss 流量。
账号在手机端退出登录，网页版会立即断开吗？
会。网页版与手机端保持实时绑定，一旦手机端退出账号，网页版会在下一次心跳检测时（约 30 秒内）失效并显示“已断开”。这是端到端加密的机制，确保任何一端登出都会终止所有会话。