微信登录在html5转app中需通过原生SDK桥接实现，不可直接使用js-SDK；android需配置包名与签名，ios需配置Bundle ID和Universal Links；获取unionid须绑定同一主体并传snsapi_userinfo权限。
微信登录在html5转APP里根本不是“嵌入”问题，而是权限和协议隔离问题
不能直接用网页版微信JS-SDK，因为HTML5打包成的APP（比如Cordova、Capacitor、uni-app或PWA封装）运行在本地webview里，没有微信客户端上下文，WXJSSDK 会报 config:invalid signature 或直接初始化失败——这不是配置错，是微信根本不允许非微信内环境调用其JS接口。
Cordova/ Capacitor项目必须走微信开放平台App SDK原生桥接
想让打包后的APP支持微信登录，唯一合规路径是接入微信官方App SDK，并通过原生插件桥接到JS层。比如：
-
cordova-plugin-wechat（需填入appid和universalLink，iOS必须配Associated Domains） -
@capacitor-community/wechat（Android需配置android/app/src/main/AndroidManifest.xml里的package和appid，且签名证书必须和微信开放平台登记的一致） - uni-app用户得用
uni.login({provider: 'weixin'})，但背后仍依赖uniplugins里的原生微信SDK，HBuilderX 3.9+才默认集成，旧版本要手动更新插件
微信开放平台注册时最容易填错的三个字段
很多团队卡在这一步导致回调失败或授权页空白：
-
包名（Android）：必须和AndroidManifest.xml中package属性完全一致，字母大小写敏感，不能带空格或特殊字符 -
Bundle ID（iOS）：不是App ID，也不是display Name，是xcode工程Target → General → Bundle Identifier那一串，例如com.example.myapp -
Universal Links（iOS）：必须启用Associated Domains，且域名要在Apple Developer后台和微信开放平台同时备案；验证文件apple-app-site-association必须放在https://yourdomain.com/.well-known/下，无后缀、无重定向、返回Content-Type: application/json
登录成功后拿不到unionid？检查scope和绑定关系
即使授权成功，返回的openid只对当前APP有效，unionid需要满足两个硬条件：
立即学习“前端免费学习笔记（深入）”；
- 用户必须已关注该微信公众号（如果用公众号网页授权方式），或已在微信开放平台将移动应用、公众号、小程序绑定到同一主体
- 调用
wx.login时传的scope要是snsapi_userinfo（不是snsapi_base），否则连nickname都拿不到，更别说unionid - 后端用
code换access_Token时，请求地址必须是https://api.weixin.qq.com/sns/oauth2/access_token，别误用https://api.weixin.qq.com/CGI-bin/token（那是公众号服务端token）
微信登录不是加个按钮就能跑通的事，每个环节都在验身份、验环境、验配置。少一个证书、错一个域名、漏一次绑定，就卡在白屏或40163错误里出不来。