小程序调用公众号网页授权：头像昵称获取与自动返回实践

方案说明

一、方案目标 让用户在小程序内打开公众号授权网页，完成头像昵称授权后自动回到原业务页，再由小程序从服务端领取资料。它适用于活动签到、互动报名等场景。 小程序登录、用户资料授权和页面返回是三个环节。“自动返回”发生在授权完成之后，仍需遵守微信的用户同意要求，不能保证所有场景都静默取得真实资料。 二、先核对两端身份 公众号与小程序的 OpenID 属于不同应用，不能直接比较。本方案要求账号关联同一微信开放平台，并由服务端核对两端实际返回的 UnionID。 UnionID 缺失或不一致时停止桥接，显示小程序原生头像选择与昵称填写入口。同属一家公司不等于已完成开放平台绑定。 三、服务端创建短期票据 小程序携带原登录令牌调用 bridge/create。服务端验证小程序会话、活动和 UnionID，生成 24 字节随机数，转为 48 位十六进制 ticket，有效期 300 秒。 Redis 将用户 ID、活动标识、原令牌摘要、UnionID 摘要及到期时间与票据关联。网页地址只带 ticket，不带登录令牌、AppSecret 或完整用户资料。 进入 bridge/entry 时，服务端原子地将 issued 改为 authorizing，并创建 OAuth state 和浏览器随机绑定值。绑定值通过 Secure、HttpOnly Cookie 保存，state 留在服务端；票据地址不得转发，日志须隐藏敏感参数。 四、公众号回调取得并核验资料 服务端发起 snsapi_userinfo 授权。用户同意后，bridge/callback 先消费 state，核对 Cookie 与有效期，再用 code 换取网页授权 access_token，调用用户信息接口取得 nickname、headimgurl 和 UnionID。 网页授权 access_token 与公众号基础接口凭证不同，相关请求及 AppSecret 均留在服务端。若使用微信 API 代理，应复用统一封装和错误处理。 本实现拒绝 is_snapshotuser=1 的快照虚拟身份。仅当两端 UnionID 一致、原登录有效、头像昵称非空且活动有效，才能将票据置为 ready；失败进入 failed。 回调只保存待领取资料，不创建新的网页登录会话，也不替换小程序令牌。 五、授权完成后自动返回 成功页先加载微信 JSSDK，再执行以下脚本；服务端通过 data-authorized="1" 标记成功。web-view 应由 navigateTo 打开，保证上一页是业务页。 let returning = false; function returnToMiniapp() { const mp = window.wx?.miniProgram; if (!mp || returning) return; mp.getEnv(env => { if (!env.miniprogram || returning) return; returning = true; mp.navigateBack({ delta: 1, fail: () => { returning = false; } }); }); } document.getElementById('return-miniapp') ?.addEventListener('click', returnToMiniapp); if (document.body.dataset.authorized === '1') { returnToMiniapp(); } getEnv 确认小程序环境后才返回。返回锁避免按钮与自动导航重复执行；导航失败释放锁，允许手动重试。失败结果页保留原因和返回按钮，不自动离开。 六、回到小程序后领取结果 UniApp 业务页在 onShow 中先执行 completeBridge，再刷新业务状态。bridge/result 使用原登录令牌和 ticket 核对用户、令牌摘要与到期时间。 ready 或 failed 结果通过 Redis 原子操作单次消费；未完成只返回 ready=false。成功资料保存到原会话的业务资料缓存，再交给正常签到或报名接口使用。 页面返回不代表签到成功，业务状态仍以服务端结果为准。不要依赖 web-view postMessage 实时传递可信资料，以服务端回调和结果接口为准。 本方案的票据时长、状态机和会话绑定属于项目设计，微信能力与配置要求见下方官方参考。