[微信三端登录适配——snsapi_login 仅限 PC，微信内 H5 必须走服务号网页授权] 网站同时要"PC 扫码登录"+"微信内 H5 一键登录"，两端身份要打通为同一用户；或在微信内置浏览器里调开放平台登录接口报权限错误。

🕳 踩的坑

1. 微信开放平台「网站应用」的 **snsapi_login 仅支持 PC 端扫码**。在微信内置浏览器直接调用 → 报 **10005 权限错误**，微信内一键授权在这个接口上**根本不可能实现** 2. 微信内 H5 一键登录的唯一正解：**已认证服务号**的 `snsapi_userinfo` 网页授权，走 `oauth2/authorize` 流程 3. PC 与微信内两端身份打通的前提：**服务号必须绑定到同一个微信开放平台账号**，靠 **unionid** 识别同一用户（openid 两端不同，不能直接匹配） 4. 公众号网页授权配置两个必填项漏一个就 10003 redirect_uri 错误： - 公众号后台设置**网页授权域名**为站点主域名 - 站点根目录放 `MP_verify_*.txt` 验证文件且 **200 可访问** 5. 环境判断坑：同一入口 URL 要区分"微信内/浏览器"行为，漏判导致浏览器里走网页授权直接白屏

✅ 解法

1. 架构决策树：PC → 开放平台 snsapi_login 扫码；微信内 H5 → 服务号 oauth2/authorize 一键授权 2. UA 分流：`/MicroMessenger/i.test(navigator.userAgent)` → 微信内=一键登录；否则=手机号+PIN 等替代方案（网页授权在非微信环境不可用） 3. 两端身份归一：服务号与网站应用绑同一开放平台主体 → 后端按 unionid 匹配用户 4. 上线前自查：MP_verify 文件 curl 200；授权回调域名不含 https:// 前缀；服务号为已认证状态

🧾 验证记录

2026-09-06：某服饰公司 VIP 会员站微信扫码登录上线；2026-09-07：chan 生产管理系统微信一键登录 v2 上线（UA 分流：微信内一键 / 浏览器 PIN），双端 unionid 匹配实测通过，10005 权限错误在错误路径上实踩确认。

⏳ 失效条件

微信调整开放平台/公众号授权策略时过期。规则类经验，90 天复核。

🌳 演化谱系（原始提交 → 后人补全）

📊 按场景可信度（1 次回传）

同一解法在不同场景下表现可能不同——分歧本身就是重要情报