网页授权域名支持子域名吗？答案是支持的，但很多人栽在细节上，微信公众平台要求填写的域名必须与页面实际跳转的域名完全一致，包括子域名在内，多一个字符都会报”redirect_uri参数错误”。
网页授权域名支持子域名吗？先说结论
支持，行业共识认为，在微信公众平台配置网页授权域名时，子域名完全可以作为授权回调地址使用，比如你的主站是example.com，那m.example.com或者open.example.com这类子域名都能配进去，但这里有个容易被忽略的前提：配置时填写的域名必须带协议头、不带路径,而且这个域名要能被公网正常访问。
很多人以为配了主域名，子域名就自动覆盖，这个想法是错的，授权回调时微信官方会做严格匹配，主域名的配置对子域名无效，反过来也一样，你想用哪个子域名做授权跳转,就得把那个完整域名单独配上去。
为什么子域名能单独配置
微信的授权流程本质上是前后端分离的OAuth2.0简化版，你在公众平台填的域名，会被视为一个”白名单”里的合法来源，校验发生在用户点击授权链接的那一刻，微信服务器会拿着redirect_uri里的域名去比对白名单，比对规则是字符串级别的精确匹配，所以只要你的子域名字符串在白名单里,校验就能通过。
网页授权域名配置时最容易忽略的细节
这里分几个层面讲,每一个都是实际开发中踩过坑的人总结出来的。
网页授权域名配置几个才算合规
很多开发者搞不清数量限制，微信公众平台上，网页授权域名最多能配2个（其他平台如企业微信可能不同，以官方文档为准），这两个名额不是给主域名和子域名各留一个的，而是完全独立的名额，如果你已经配了
example.com和m.example.com，那第三个域名就配不进去了,得先删掉一个旧的。
- 每个公众号有2个网页授权域名配额
- 修改后立即生效，但旧的配置会被覆盖
- 配置时需下载
MP_verify_xxx校验文件并放到域名根目录
从平台设计逻辑来看，配额是出于安全考虑，防止域名被滥用跳转，做多站点业务的团队，在设计授权域名方案时就要想清楚，是走主域名路由分发,还是直接占用两个配额。
网页授权域名和服务器域名有什么不同
这是高频混淆点。服务器域名配的是API接口调用地址，微信服务器要能访问到你后端的请求处理接口；网页授权域名配的是前端页面跳转地址，用户浏览器地址栏里的域名，两者有可能相同,但审核逻辑完全不同。
举个例子：你的后端接口是api.example.com，网页是m.example.com，那服务器域名就填api.example.com，网页授权域名填m.example.com，如果填反了，前端跳转时就会收到”redirect_uri域名与后台配置不一致”的报错。这两个配置项不是继承关系，必须各自单独维护。
网页授权域名配置后多久能生效
修改配置后通常1分钟内生效，但微信有缓存机制，极端情况下可能需要5分钟左右，测试时建议用无痕窗口，避免之前登录态的干扰，如果配置后报错误代码40029或40163，先检查时间戳和code的有效期,这两类错误跟域名配置关系不大。
子域名授权配置的完整操作路径
按下面的步骤走，能少走不少弯路，这里假设你用open.example.com
作为授权域名。
- 登录微信公众平台，进入”设置与开发” > “接口设置”模块
- 找到”网页域名”一栏，点击修改
- 下载校验文件
MP_verify_你的序列号.txt - 把校验文件上传到
open.example.com的根目录下，注意不是子目录 - 在输入框里填写
https://open.example.com，别带路径，别带www前缀（除非你本来就打算用www） - 点击保存，等待校验通过
整个过程用不了3分钟,但有几个操作细节要单拎出来说清楚。
填域名时常见的手误
- 带了路径：填成
https://open.example.com/callback是错的，微信只要域名部分 - 大小写不一致：
Open.Example.com会被判定不匹配 - 端口号：如果你用了非80/443端口，微信不支持填端口，
https://open.example.com:8080这种写法会直接报错 - http和https混用：填了
http://，但页面实际用https://跳转，依然会校验失败
校验文件放置的玄机
校验文件名是微信生成的，内容也是固定的，大小写必须与后台显示一致，放置位置是域名的web根目录，如果你的子域名是独立服务器，放到/var/www/html/这类目录即可；如果是反向代理，确保代理规则没拦截.txt文件，校验文件不要随便删除,后面每次修改配置都可能要用到。
网页授权域名配置后如何验证
配置完成不等于万事大吉，建议按下面的方法自测一遍,确认授权链路是通的。
- 在浏览器直接访问
https://open.example.com/，确认地址栏显示为完整子域名 - 用微信公众号后台的”接口调试工具”，填入你的子域名和回调路径，查看返回结果
- 检查前端代码里的
redirect_uri参数是否经过了encodeURIComponent编码，这点极容易忽略，很多报错都是因为参数没编码导致微信解析域名时多出了字符
如果调试工具返回scope和code字段，说明授权域名配置已经生效，如果返回错误信息,优先检查域名是否完整体现在报错提示里。
常见的网页授权域名配置问题汇总
这里把后台咨询量最大的几个实际问题集合解答。
Q1: 网页授权域名支持子域名吗，主域名能直接授权给子域名用吗？
不支持，主域名配置只对主域名本身生效，子域名要单独配置，如果你的业务需要在多个子域名间跳转授权，建议要么统一到一个子域名,要么占用两个配置名额。
Q2: 网页授权域名配置了多个，会不会影响速度？
不会影响授权速度，授权请求是微信服务器处理的，域名数量不参与性能计算，但多个域名意味着校验文件要分别放置，维护成本会上升，从行业实际情况看，多数团队最终会收敛到一个域名,减少复杂度。
Q3: 网页授权域名支持ip地址或localhost吗？
不支持填IP地址。0.0.1和局域网IP都过不了校验，本地开发时，可以通过修改本机hosts文件，把open.example.com指向0.0.1，然后保证本地服务监听80或443端口,这样就能绕过限制进行联调。
最后说一句
网页授权域名支持子域名，答案很明确，但配置过程容不得半点马虎，记住三个核心点：完整填写域名、不带路径、校验文件放对位置，等你把授权流程跑通，再回头看这个配置,其实就那么回事。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/629628.html
