> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 微信扫码登录排障

> 微信扫码登录常见问题排查：二维码不显示、redirect_uri 参数错误、扫码后登录失败、发布后无法登录，按现象定位授权回调域与凭证配置问题.

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

<Note>
  当前应填写的授权回调域，可在 superun 项目的「微信扫码登录 → 配置」页查看并复制；项目未发布时显示预览域名，发布后显示正式域名。
</Note>

## 二维码区域显示「redirect\_uri 参数错误」

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

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

## 二维码区域一直空白

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

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

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

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

<Warning>
  AppSecret 是 32 位字符的密钥，不以 `wx` 开头。误填 AppID 或小程序密钥是最常见的错误，会导致扫码后登录失败。
</Warning>

## 扫码成功但登录失败

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

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

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

## 仍未解决

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