扫码登录失败主因是userSig无效或设备时间偏差超300秒，需检查控制台账号状态（待激活/已禁用）、userSig签名与有效期，并校准设备时间。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯IM SDK扫码登录后页面卡在加载状态或提示“登录失败”，说明二维码已成功识别但身份校验未通过，此时不能反复刷新二维码，需立即检查 userSig 有效性与设备时间同步性。
确认二维码对应账号是否已启用
登录失败的第一原因不是网络或手机问题，而是该 userID 在控制台处于禁用或待激活状态。进入即时通信 IM 控制台 → 团队管理 → 成员列表，查找扫码所用账号的「状态」列。
若显示「待激活」，说明管理员添加成员后系统已发随机密码邮件，但用户尚未点击邮件内链接完成首次登录；此时直接用邮件中的密码+userID登录Web管理端即可激活，【切勿在SDK中点击“重置密码”】，否则原邮件凭证立即失效且新密码不会下发到扫码端。
若显示「已禁用」，需超级管理员在操作列点击「恢复上线」，禁用状态下扫码动作本身能成功，但后续所有鉴权请求均被服务端直接拦截。
检查 userSig 是否过期或签发错误
方法一：用调试工具抓取扫码后 SDK 发出的 login 请求
在 Chrome DevTools 的 Network 标签页中过滤 xhr，找到含 /v4/im/login/ 的请求，点开查看 Payload 中的 userSig 字段。将该字符串粘贴至 https://cloud.tencent.com/document/product/269/32688 提供的在线解码工具中解析。
版本定位为桌面办公端，适合 Windows 用户处理本地文件、资料阅读、问答写作和知识库管理。主要特性围绕桌面端文件处理、知识库调用和 AI 工作台操作展开。建议从官网或官网公开下载包获取，不建议使用第三方搬运包。适合生产环境使用。注意事项是当前仅查到 x64 安装包，暂未查到官方公开 ARM Windows 安装包。
若解码失败或提示“签名无效”，说明密钥（SDKSecretKey）未用于当前签发，或 time 字段已超时（默认有效期为24小时）；若 exp 字段早于当前时间戳，则 userSig 已过期，必须重新生成。
方法二：本地重签一份临时 userSig 快速验证
用控制台获取的 SDKAppID 和 SDKSecretKey，在 debug 目录下运行官方提供的 Python 签发脚本（如 sign_usersig.py），传入当前 userID，生成新 userSig 后硬编码进 demo 的 login 接口调用处；若此时扫码可通，即确认原 userSig 是唯一瓶颈。
验证设备系统时间是否严重偏差
第一步：打开手机设置 → 系统与更新 → 日期和时间 → 开启“自动设置日期和时间”
第二步：若使用模拟器或企业定制 ROM，手动校准至误差 ≤ 30 秒。userSig 中的 time 字段参与 HMAC-SHA256 签名计算，服务端会比对请求到达时间与 time 值之差，【偏差超过 300 秒将直接拒绝登录】，且不返回具体错误码，仅表现为扫码后无响应。
第三步：重启 App 并重新扫码。时间校准后无需重装或清除缓存，SDK 在下次 login 调用时会自动携带新时间戳生成的签名参数。
