微信扫码登录排障

本文是 微信扫码登录 的补充。扫码登录出现异常时，绝大多数问题出在微信开放平台侧的配置（授权回调域、应用审核状态）或凭证填写，按下面的现象逐条对照，多数问题可以在几分钟内自行解决。

​

二维码区域显示「redirect_uri 参数错误」

微信在生成二维码前会先校验两件事，任何一项不通过都会显示这个错误，而不是二维码：

1. 授权回调域未配置或与实际域名不一致。 到微信开放平台「管理中心 → 网站应用 → 开发配置 → 开发信息 → 域名信息」，把「微信扫码登录 → 配置」页展示的授权回调域原样填入。只填域名，不含 https://、端口和路径。
2. 网站应用尚未通过审核。 应用在审核通过前无法使用扫码登录，请在微信开放平台查看审核状态。

​

二维码区域一直空白

二维码脚本由微信官方域名（res.wx.qq.com）提供，区域一直空白通常是脚本加载失败：

• 检查设备网络后刷新页面重试；
• 如果页面提供了「重新加载」按钮，点击重试。

​

提示凭证缺失或二维码无法初始化

AppID / AppSecret 尚未保存到 superun。到「微信扫码登录 → 配置」页点「修改凭证」，填入微信开放平台网站应用的 AppID 和 AppSecret 并保存。

​

扫码成功但登录失败

• 提示安全校验失败：二维码停留时间过长或页面被重复使用，回到登录页重新扫码即可。
• 提示授权码无效或已使用：微信授权码约 10 分钟有效且只能使用一次，重新扫码获取新的授权码。
• 反复失败：多为 AppSecret 填错（见上一节），重新保存凭证后再试。

​

项目发布后微信登录突然失效

项目发布后，访问域名会从预览域名切换为正式域名，而微信开放平台仍登记着旧域名。到「微信扫码登录 → 配置」页复制当前展示的授权回调域，到微信开放平台更新后即可恢复。

​

仍未解决

在项目对话中直接描述现象（例如「二维码不显示」「扫码后提示登录失败」），superun 会结合项目日志进一步排查。