扫码登录本来是最省事的方式：手机扫一下，电脑就进去了。可一旦失败，屏幕上往往只有一句含糊的提示，让人不知道该从哪查起。理解它的工作方式，排查会快很多。
一、扫码登录到底做了什么
电脑端生成二维码时，会同时创建一个带时效的登录凭证，这个凭证只在云端短暂有效。手机扫码后读取凭证，向服务器确认“这个账号同意登录这台设备”，服务器再把结果回传给电脑端，电脑端凭结果换取正式登录状态。
整条链路涉及三个角色：电脑、手机、服务器。任何一环出问题，表现都是“扫了没反应”。所以排查思路不是反复扫，而是先判断断在哪一环。
二、先做三个快速判断
- 二维码是否在倒计时刷新？不刷新说明电脑端与服务器没连上；
- 手机扫码后是否出现确认页面？没有说明扫码识别环节就失败了；
- 手机上是否收到“新设备登录”的提示？有提示但电脑没进，问题在回传环节。
这三个问题能快速把范围缩小。比如二维码不刷新，就不必去检查手机摄像头权限，直接看电脑网络。
三、按线索逐项排查
网络与代理
最常见的原因。公司网络、校园网或开启了代理的环境，可能拦截登录相关的请求。先关掉代理再试一次；如果必须使用代理，确认代理规则没有把相关域名排除在外。也可以换手机热点测试，能连通就说明原网络有限制。
设备时间不同步
登录凭证带时效，设备时间偏差过大时，凭证会被判定为过期。电脑与手机都开启自动同步时间即可，这在长期不关机的电脑上尤其容易出现偏差。
客户端版本过旧
旧版本可能使用已调整的登录接口，扫码后无法正确回传结果。把 Potato电脑版 更新到当前版本再试，具体版本与支持情况请以官方渠道为准。
摄像头与相册权限
手机端如果没有相机权限，扫码界面可能一片黑却没有任何提示。到系统设置里检查权限，或改用“从相册选择二维码”的入口。
账号状态异常
在新设备上登录可能触发安全验证，如果账号处于受限状态，扫码会被静默拒绝。此时改用账号登录，通常会直接给出具体原因。
四、替代方案与应急处理
扫码不通时，不要一直刷二维码。可以改用账号加验证码登录，这条路走的是不同的验证流程，往往能绕开扫码环节的故障。登录成功后，再回头排查扫码问题就没那么急了。
如果是临时要在他人电脑上登录，建议登录后立即检查是否有“保持登录”之类的选项，用完主动退出，并清理本地缓存。公共设备上留下登录状态，风险不小。
还有一种容易被忽略的情况：电脑上同时开着多个客户端实例，或者旧进程没有完全退出，新的登录请求会与旧会话冲突。彻底退出程序（包括托盘中的后台进程）再重新打开，往往一次就好。
五、减少再次发生的习惯
保持土豆聊天客户端与系统更新；不要把系统时间改成手动；在公司或校园网络环境下，如果反复失败，优先用手机热点完成一次登录，再判断是否为网络策略问题；定期检查账号的登录设备列表，把不认识的设备移除。更多账号相关的说明可以看 常见问题解答。
扫码失败并不神秘，本质是三方链路中的某一环断了。按“二维码是否刷新、手机是否确认、电脑是否收到结果”三步定位，再对应检查网络、时间、版本与权限，多数问题在几分钟内就能解决。