资讯 / 文章页
网页授权报 10003,是业务域名配错了吗?先看官方对 redirect_uri 和授权回调域名的说明
微信外链
2026-11-18

网页授权报出 10003 时,有人会先去改业务域名,认为一定是这一项配错了。2026年11月18日(北京时间)阅读的微信开发文档里,错误码 10003 的说明是「redirect_uri域名与后台配置不一致」;授权登录常见问题第 3 条的标题也是「微信登录失败,redirect_uri 域名与后台配置不一致,错误码 10003」。两页指向的都是 redirect_uri 和「网页授权域名」(也就是授权回调域名)是否一致,并没有把 10003 写成业务域名错误。之所以会先想到业务域名,常常是因为要在微信里打开网页时,还会碰到其他域名配置;但 10003 的官方说明并https://cdn2.quma.cn/uploads/2/2026/11/18/FvfXw8o6_Iba5q0ShyVuzxnek40c.jpg

没有点到那一项。要把「网页里用到的其他域名项」和「网页授权这一笔报错指向的域名」分开,本题只讨论后者。先读官方怎么写 redirect_uri 和授权回调域名,而不能从报错直接推出「一定是业务域名配错了」。

10003 官方指向的是网页授权域名,不是业务域名这一项

《微信网页授权》的错误码表把 10003 写成「redirect_uri域名与后台配置不一致」。该页写明:授权后重定向的回调链接地址是 redirect_uri,须做 URL 编码,并且必须要和「网页授权域名」的配置一致。配置入口写在「设置与开发 - 账号设置 - 功能设置」,修改的是「网页授权域名」。

《授权登录常见问题》第 3 条同样写:构造授权链接的 redirect_uri,必须与在微信公众平台「设置与开发 - 账号设置 - 功能设置 - 网页授权域名」的配置一致,不一致则会出现 10003。该条没有把 10003 归因于业务域名,也没有归因于 JS 接口安全域名。

因此,看到 10003,先应对到「redirect_uri 的域名」和「网页授权域名」这一对对象。业务域名是另一项配置,这两份页面都没有说 10003 等于业务域名配错。不能根据 10003 写成官方认定就是业务域名错误,也不能反过来断言业务域名一定没有问题——只是这笔报错在官方说明里,并没有指向那一项。

先分清 redirect_uri 和网页授权域名各是什么

redirect_uri 是授权之后要回到的回调链接地址,是一条具体的链接,不是只填一个域名。官方要求它必须和已经配置的网页授权域名一致,并且须做 URL 编码。《微信网页授权》还写了注意事项:跳转回调 redirect_uri,应当使用 https 链接,以确保授权 code 的安全性。这是该页对安全性的要求,文中没有把「未使用 https」单独列为 10003 的原因,本文也不补写成「不是 https 就一定会报 10003」。

网页授权域名填写的是域名,不是一整段网址。官方明确写:不要加 http:// 等协议头;要按全域名来配置。如果把完整的 redirect_uri 整段贴进「网页授权域名」,或在域名前面加上协议头,就已经和该页「填写的是域名不是 URL」这一要求不一致。这和下面子域名不自动复用是同一层配置对象问题,仍然指向网页授权域名,而不是改去业务域名。该页举的例子是:配置为 www.qq.com 后,该域名下的页面可以进行授权,但 pay.qq.com、music.qq.com、qq.com 无法进行网页鉴权。也就是说,子域名并不会因为主域或某个兄弟子域已经配置过,就被自动复用。这是官方举例,用来说明配置对象是哪一层域名,不是某个站点的实测结果。

核对时要把「回调链接整段」和「后台填的那一条域名」分开:前者是 redirect_uri,后者是网页授权域名。只改了别的域名项,却没有把这一对对象对上,并不能回答 10003 在官方说明里指向的问题。

常见问题页还写了端口,账号条件两页表述也不完全相同

《授权登录常见问题》第 3 条有两条注意事项。第二条写:redirect_uri 不支持带端口号,否则也会出现 10003 报错。也就是说,即便域名看起来已经和网页授权域名一致,只要回调地址带了端口,按该页说明仍可能走到同一条错误码。本文未实测带端口的请求,只转述官方已经写出的这一条。

账号条件需要并列看,不能只取其中一句。网页授权文档写:网页授权支持已认证的服务号;其他类型账号,包括部分公众号、小程序、网站应用、移动应用等,除已认证服务号之外均不支持。该页另有特殊补充:已认证的政府、事业单位和媒体类型的公众号也有权限。授权登录常见问题第 3 条则写:必须是已认证的服务号才有权限使用微信网页授权功能,公众号或者未认证的服务号都不支持。两页都强调已认证的服务号,但对「公众号」是否一概不支持,表述并不完全相同。本文只并列转述,不自行断言哪一句覆盖另一句,也不补写未出现的开通或认证步骤。

另外,《微信网页授权》还写:参数顺序不对,则授权页面将无法正常访问。该页没有把「参数顺序不对」归入 10003。错误码表里还有 10005、10011、10016 等,同样不是本题要展开的对象。该页也公布过用户信息接口不再返回性别及地区、不规范使用某种授权范围将默认打开网页快照页等说明,生效日期分别写在 2021 年和 2022 年,不能当成今天的新规则来理解,也与 10003 不是同一件事。

遇到 10003 时,可以按官方已经写出的条目来核对

比较稳妥的做法,不是先改到业务域名,而是按官方条目把对象对上。可以留下一组简单记录:

- 报错原文是不是 10003,官方对应说明是不是「redirect_uri域名与后台配置不一致」

- 授权链接里的 redirect_uri 是哪一条,域名部分是否与「网页授权域名」一致;网页授权域名有没有误加成带协议头的网址,有没有把子域名、上级域名或兄弟子域当成已经生效的同一条

- redirect_uri 是否带了端口号;常见问题页把带端口也列为会报 10003

- 当前账号条件如何对照两页已经写出的范围;对「公众号」的表述两页并不完全相同,应并列记下,而不是只保留其中一句

- redirect_uri 是否按该页要求使用 https,这与授权 code 的安全性有关,但页面没有把它单独写成 10003 的原因,不能直接当成同一条报错的结论

- 业务域名、JS 接口安全域名如果也做了检查,应标明它们并不是这两页给 10003 列出的指向,不能把检查结果写成「官方认定就是这一项错了」

这类核对只帮助判断问题是不是落在 redirect_uri 与网页授权域名这一层,不能写成「按这份清单改完就一定不再报 10003」。本文未登录任何公众平台后台,也未复现 10003,不把某一次修改结果写成已经验证的修复方法。

看到 10003,先不要把它收成「一定是业务域名配错了」。能分开的是:官方把这笔错误指向 redirect_uri 的域名与网页授权域名是否一致,常见问题页还写了不支持端口号,账号条件要并列阅读两页原文。业务域名没有出现在这两页对 10003 的说明里,就不能写成官方认定是业务域名错误。最终仍以当时对照官方条目核对的结果为准。

参考资料

[1] 微信网页授权 https://developers.weixin.qq.com/doc/service/guide/h5/auth.html,最后一次编辑于 2026-07-04,访问日期 2026-11-18(北京时间)。该页写明 redirect_uri 须与「网页授权域名」配置一致,域名不加协议头,子域名不按已配置域名自动复用,错误码 10003 为「redirect_uri域名与后台配置不一致」,并写跳转回调应当使用 https。

[2] 授权登录常见问题 https://developers.weixin.qq.com/doc/oplatform/developers/troubleshooting/auth.html,最后一次编辑于 2026-05-27,访问日期 2026-11-18(北京时间)。第 3 条专讲 10003,要求 redirect_uri 与网页授权域名一致,并写明必须是已认证的服务号才有权限、redirect_uri 不支持带端口号。该页未把 10003 归因于业务域名或 JS 接口安全域名。

购买咨询
微信扫码咨询
400-600-7511