网页授权域名指的是你在微信公众平台或开放平台后台配置的、用于接收微信OAuth2.0授权回调的完整URL中的域名部分。直白说，当用户点击“微信登录”后，微信服务器会把用户带回你的网站，这个“带回”动作要跳转到的地址，其域名必须是你在后台白名单里填写的那个,否则微信会直接拦截并报错。
什么时候会用到这个域名
这个域名不是随便填着玩的,只在特定场景才会触发校验。
![[公众号全栈开发] 1.配置网页授权域名(内网穿透](https://i1.hdslb.com/bfs/archive/d8de7be0c1c8bdc733c9c7cfa080aa18e4bfbac4.jpg)
- 网站应用接入微信登录：你的PC端或移动端网页需要让用户用微信身份登录，前端调用
https://open.weixin.qq.com/connect/qrconnect接口，跳转参数里的redirect_uri必须指向已授权域名下的页面。 - 公众号内网页授权：用户在公众号菜单或图文消息里打开你的H5页面，页面需要获取微信用户的基本信息（头像、昵称、openid），此时会调用
https://open.weixin.qq.com/connect/oauth2/authorize接口，同样要求redirect_uri域名在后台已配置。 - 微信支付JSAPI下单：虽然支付本身用的是
wx.chooseWxPay，但很多业务场景下用户需要先完成网页授权,这个前置步骤同样依赖已配置的授权域名。
一个容易踩坑的细节是：如果用户从公众号菜单直接进入H5页面，没有走授权回调流程，此时后台不校验域名；一旦你调用了wx.authorize或getUserProfile这类接口，微信就会在回调环节检查域名匹配性，没有触发授权逻辑时测试正常，一调接口就报错”是常见现象。
网页授权域名填什么？填在哪？
这里说的“填什么”包含两层意思：一是具体填哪个值,二是填在后台哪个位置。
第一层：填域名本身，不是填URL
需要填入的是不带http://或https://协议头、不带路径、不带端口号的纯域名，以https://www.example.com/wechat/callback为例，你要填的是www.example.com，而不是example.com/wechat/callback，更不是www.example.com/wechat。
第二层：填在开发配置的“网页授权域名”输入框
操作路径有两条,取决于你的应用类型：
- 公众号（订阅号或服务号）：登录微信公众平台 → 左侧菜单“设置与开发” → “公众号设置” → “功能设置” → 找到“网页授权域名”这一项,点击修改。
- 开放平台网站应用：登录open.weixin.qq.com → “管理中心” → “网站应用” → 选择你的应用 → “开发信息” → “授权回调域”。
两道工序在这里有区别：公众号的网页授权域名是全局生效的，一个公众号同时只能配置一个域名（部分特殊类目可配置多个，但绝大多数情况是单域名）；开放平台网站应用则可以配置多个授权回调域。
网页授权域名和回调域名区别
虽然“网页授权域名”和“回调域名（redirect_uri域名）”在官方文档中经常混用，它们指向的是同一个东西的不同侧面，为了帮你彻底分清,我用一个表格说明：
| 维度 | 网页授权域名 | 回调域名（redirect_uri域名） |
|---|---|---|
| 定义 | 后台白名单配置项 | 请求参数中redirect_uri的域名 |
| 作用 | 微信判断是否放行回调的依据 | 告诉微信用户授权后往哪跳 |
| 报错逻辑 | 微信拿它和redirect_uri比对 |
不匹配则拒绝跳转 |
| 配置位置 | 公众平台“功能设置”或开放平台“开发信息” | 代码里动态拼接，无需单独配置 |
举个例子：你把后台网页授权域名配成www.a.com，但代码里redirect_uri写的是www.b.com/oauth/callback，微信返回的报错是redirect_uri参数错误，此时你不需要改代码，只需要把www.b.com也加进网页授权域名白名单（如果支持多域名），或者把redirect_uri改成www.a.com下的路径。
这里有一个业内专家的普遍共识：网页授权域名就是回调域名的“合法名单”，回调域名是你实际使用的“门牌号”，门牌号必须出现在合法名单里，否则不让你进门。
配置时的三个硬性要求
就算你把域名填对了,也可能因为下面几个细节被卡住。
域名必须完成ICP备案
微信要求网页授权域名必须是已经完成ICP备案的域名，且在有效期内，用未备案的域名配置，系统会直接提示“域名未备案”，如果你的服务器在海外，域名没有备案，那就不能用这个域名做网页授权，要么换备案域名,要么走其他认证方案。
域名不支持IP地址和端口号
http://192.168.1.1、https://www.example.com:8080这种写法，微信后台根本不让填，填IP地址会提示“格式不正确”，填带端口的域名会提示“域名错误”，原因在于微信回调机制强制走443端口（HTTPS）,而且要求域名可公网访问。
HTTPS证书必须有效
微信要求授权回调地址必须使用HTTPS协议，证书链完整、未过期，如果你用http://开头，或者证书过期，用户点击授权后会看到“无法连接”或“链接不安全”的警告，导致流程中断，有个容易被忽略的坑：证书必须和域名匹配,用其他域名的证书或通配符证书覆盖不当也会校验失败。
网页授权域名配置失败的排查思路
这里收集了最常见的三种报错场景，几乎覆盖了90%的配置问题。
redirect_uri参数错误
这是最高频的报错，你按上面说的检查顺序逐项核对：后台域名填的有没有带https://？有没有写过路径？代码里redirect_uri拼的是不是完整URL（含协议头）？URL编码做了没有？redirect_uri参数值是必须先做urlencode再拼接的,少一层编码就会出错。
该公众号暂时无法提供服务
这个报错比较隐晦，原因通常不是你配置错了，而是后台还没生效，保存配置后需要清掉微信返回的缓存或等1-2分钟，部分情况下需要重启一下web服务器，另一个可能是：你用的不是服务号，而是订阅号，订阅号没有网页授权的高级接口权限（用户基本信息），只有服务号才能获取用户openid和详细信息，行业共识是，如果你的账号类型是订阅号且未认证,基本上和网页授权功能无缘。
多次配置后提示“频率限制”
微信后台对网页授权域名的保存操作有调用频率限制，短时间内反复修改会触发拦截，遇到这种情况，停止操作等待15分钟后再试，这个限制是接口层面的,不是人为判断。
一个实操范例：从配置到跳转
为了让你直观理解，我描述一个完整的验证过程,你可以在自己的机器上照做。
假设你的域名是www.wechatdemo.cn
，服务器上有一个路径为/wechat/callback的页面。
第一步，登录微信公众平台，把www.wechatdemo.cn填入网页授权域名,保存后通常秒级生效。
第二步，构造一个测试链接（假设公众号appid是wx1234567890）：
https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx1234567890&redirect_uri=https%3A%2F%2Fwww.wechatdemo.cn%2Fwechat%2Fcallback&response_type=code&scope=snsapi_userinfo&state=123#wechat_redirect第三步，在手机微信里打开这个链接，你会发现跳转到了https://www.wechatdemo.cn/wechat/callback?code=xxx&state=123，说明授权域名配置成功，如果你把链接里的redirect_uri换成另一个域名，微信就会直接报错,证明白名单校验是严格生效的。
常见问题解答
Q1：网页授权域名只填主域名行不行？比如用二级域名还是顶级域名？
填哪个域名，取决于你的业务代码跑在哪个域名下，如果页面和回调都在www主域名下，就填www.example.com；如果用m.example.com做移动端H5，就填m.example.com，微信校验的是精确匹配，不会自动兼容主域名和子域名，除非你在后台把两个域名都加上（开放平台支持，公众号受数量限制），填顶级域名example.com并不能覆盖www.example.com的访问。
Q2：网页授权域名配置好了，但用户手机打开页面还是提示“无法获取用户信息”，是什么原因？
多数情况下，问题出在代码逻辑而非域名配置，检查两点：一是scope参数是否用了snsapi_userinfo（静默授权snsapi_base只能拿到openid，拿不到昵称头像）；二是你的服务器是否成功用code换取了access_token并调用/sns/userinfo接口，如果你在浏览器（非微信内置浏览器）里测试，也会被拦,因为网页授权必须在微信客户端或通过扫码方式发起。
Q3：换服务器IP了，网页授权域名要重新配置吗？
不需要，网页授权域名绑定的是域名本身，和服务器IP没有关联，只要域名解析指向新IP，且新服务器上部署的代码、HTTPS证书都正确，授权流程就会自动恢复正常，微信只关心你请求的redirect_uri是否在白名单内。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/614483.html
