登录失败排查手册
二维码不显示或反复刷新
先确认浏览器版本：Chrome 需 90 以上、Edge 需 90 以上、Firefox 需 88 以上、Safari 需 15 以上。版本过低时页面脚本可能无法执行，表现为二维码区域空白。其次检查网络：二维码请求走 HTTPS，若公司网络对相关域名做了拦截，页面会一直停在加载状态。可在浏览器开发者工具的 Network 面板观察请求是否返回 4xx 或 5xx。
扫码后手机提示「无法关联设备」
常见原因有三类：一是手机端已关联设备达到上限（通常 4 台），需先在「已关联的设备」中移除一台旧设备；二是手机系统时间与网络时间偏差超过 5 分钟，导致凭证校验失败，可在系统设置中开启自动时间同步；三是二维码已过期，页面每 20 秒刷新一次，扫码时请对准当前显示的二维码。
电脑端一直显示「正在连接」
这说明配对已成功但长连接未建立。按以下顺序排查：
- 刷新页面，观察是否直接进入会话列表（凭证有效期内无需重新扫码）。
- 切换网络，例如从公司 Wi-Fi 切到手机热点，排除防火墙对 WebSocket 的拦截。
- 检查浏览器是否开启了「严格跟踪保护」或类似隐私模式，这类模式可能阻断长连接。
- 在手机端确认该设备仍显示为「在线」，若显示离线则在手机端重新打开 WhatsApp。
登录后聊天记录为空
网页版同步的是手机端当前保留的聊天记录，若手机端已清理过对话，网页端不会显示历史消息。此外，首次同步需要时间，记录较多时可能持续 1 分钟以上，期间不要关闭页面。若长时间为空，可在手机端「已关联的设备」中注销该设备后重新扫码。
公用电脑上的安全操作
使用完毕后点击左下角设置中的「退出登录」，该操作会立即注销当前设备凭证。不要仅关闭浏览器标签页，因为凭证在有效期内仍然有效。若怀疑凭证泄露，直接在手机端移除该设备即可远程失效。