资讯 / 文章页

网页授权里的 snsapi_base 和 snsapi_userinfo,拿到的是不是同一种结果?先看官方对授权作用域的说明

微信外链
2026-11-21

在微信里打开第三方网页做授权时,有人会把授权作用域里的「snsapi_base」和「snsapi_userinfo」当成同一种结果:只要走了网页授权,就以为一定弹出确认框,也一定拿到昵称、头像等基本信息;或者反过来,看见能够识别用户,就以为已经完成了用户基本信息授权。2026年11月21日(北京时间)阅读的微信开放文档《微信网页授权》(页标最后一次编辑于 2026-07-04)写明,目前网页授权有两个 scope,分别是「snsapi_base」和「snsapi_userinfo」,并对静默、弹窗和随后能获取的信息作了区分。同一天并行阅读的《网页

https://cdn2.quma.cn/uploads/2/2026/11/21/FsvP0-mlpA57IVrh8q5TDNDifHJo.jpg

应用授权登录》(页标最后一次编辑于 2026-05-27)对这两个作用域的核心解释一致,但对适用账号等表述并不完全相同。以下以服务号文档为主线转述,两页不一致处并列写出,不自行调和。本文不是完整的授权对接教程,也不把网页授权写成可以绕过外链拦截或强制跳转,更不宣称任何第三方工具已经接入该能力。

官方写明目前有两个授权作用域,不是同一种结果

服务号文档在构造授权链接的参数说明里,把「scope」解释为应用授权作用域,并分别写了两种:「snsapi_base」(不弹出授权页面,直接跳转,只能获取用户 openid),「snsapi_userinfo」(弹出授权页面,可通过 openid 拿到昵称、性别、所在地。并且,即使在未关注的情况下,只要用户授权,也能获取其信息)。

紧接着,该页又用两段解释作了补充。「snsapi_base」:用来获取进入页面的用户的 openid,并且是静默授权并自动跳转到回调页的;不会弹出信息确认框,仅能获取用户 openid 等信息,无法获取昵称头像。「snsapi_userinfo」:用来获取用户的基本信息;但这种授权需要用户手动同意;由于用户同意过,所以无须依赖用户关注服务号,就可在授权后获取该用户的基本信息。

并行页对这两个作用域的上述解释,与服务号文档一致。按这些已经写出的句子,两个 scope 不是同一种结果:一个默认静默、主要落到用户标识;另一个用于获取基本信息,并在说明里对应弹出授权页面或需要用户手动同意。至于「性别、所在地」和页首调整公告如何同时出现,后文单独列出,这里先只分清两个作用域本身。

授权链接中的 redirect_uri 必须与公众平台里配置的网页授权域名一致,否则可能出现 10003 等提示。那是域名和回调地址是否配对的核对,不是本题要比较的两种 scope,本文只在分界时点到,不展开成域名配置说明。

「snsapi_base」默认静默,结果主要落到用户标识

当授权作用域是「snsapi_base」时,服务号文档写得很直接:客户端默认同意。它被写成静默授权并自动跳转到回调页,不会弹出信息确认框,只能获取用户 openid 等信息,无法获取昵称头像。参数表里的对应表述是「不弹出授权页面,直接跳转,只能获取用户 openid」。

在换取用户授权 Token 一节,该页还写:在「snsapi_base」情况下,无法也不需要调用任何接口。也就是说,按官方已经写出的层次,选这个作用域,并不是少走了一步「拉取用户信息」,而是这一步本身不属于它的结果范围。并行页在这一点上的表述同样是:在「snsapi_base」情况下,无法也不需要调用任何接口。

本文不把随后的接口地址、参数表写成可复制的接入步骤。需要记住的只是官方已经划开的结果边界:这个作用域静默跳转,拿到的是以 openid 等用户标识为主的结果,不能把它理解成已经取得了昵称、头像等基本信息。

「snsapi_userinfo」用于获取基本信息,但弹窗不是每一次都会出现

「snsapi_userinfo」在参数表里被写成「弹出授权页面」,在补充解释里被写成需要用户手动同意,并可在授权后获取用户基本信息,而且无须依赖用户关注服务号。换取 Token 之后,官方写明:在「snsapi_userinfo」情况下,可以执行获取用户信息、刷新 Token、检验 Token 有效性;并另设「拉取用户信息」一节,说明若作用域为「snsapi_userinfo」,此时可以通过 access_token 和 openid 拉取用户信息。返回参数里还写:unionid 只有当 scope 为「snsapi_userinfo」时返回。

但「需要用户手动同意」,并不等于每一次都会弹出确认框。服务号文档在「获取用户授权」里写了两种情况。情况1:对于已关注服务号的用户,如果用户从服务号的会话或者自定义菜单进入本服务号的网页授权页,此时静默授权,无需用户在弹窗同意。情况2:在非情况1的其他情况下,若使用用户交互(点击按钮)跳转授权链接,微信会拉起弹出窗口确认;若用户未做任何交互动作、直接跳转授权链接,网页将被固化,展示「点击访问完整网页」字样,微信不推荐打开网页就直接授权的业务场景。并行页对这两种情况的写法与此一致。

参数表里还有可选参数「forcePopup」:强制此次授权需要用户弹窗确认,默认为 false;若用户命中了特殊场景下的静默授权逻辑,则此参数不生效。也就是说,官方已经写明存在特殊场景下的静默授权逻辑,而且这一逻辑可以让强制弹窗参数不生效。本文只转述这句限制,不补哪些场景一定命中、哪些一定不命中。

两份文档的账号范围并不完全相同,页上的调整说明也要一并核对

服务号文档(页标 2026-07-04)写:网页授权支持已认证的服务号使用,其他类型的账号(部分公众号/小程序/网站应用/移动应用等除了已认证服务号之外的账号)均不支持使用微信网页授权登录功能;特殊补充:已认证的政府、事业单位和媒体类型的公众号也有权限。该页在说明配置「网页授权域名」时还写:如果没有看到这个选项,说明你的账号不支持此功能。

并行页(页标 2026-05-27)写:网页授权仅支持已认证的服务号,其他类型的账号(公众号/小程序/网站应用/移动应用等除了已认证服务号之外的账号)均不支持;补充说明:已认证的政府和媒体类型的公众号也有权限。这里没有写「部分公众号」,也没有写出「事业单位」。两页对 UnionID 的适用表述也不完全一样:服务号文档写的是在多个服务号,或在服务号、移动应用、小程序等之间统一用户账号;并行页写的是在多个服务号,或在服务号、移动应用之间统一用户账号,后文另补充可通过 unionid 区分同一开放平台下不同应用的用户,并给出速记公式。这些差异按原文并列记录,不自行收成一种说法。

另外,两页文首都有能力调整说明:服务号用户信息获取接口将不再返回用户性别及地区信息,能力调整已于 2021 年 10 月 20 日 24 时生效。与此同时,参数表仍写「snsapi_userinfo」可通过 openid 拿到昵称、性别、所在地;「拉取用户信息」的返回说明里也仍列出了 sex、province、city 等字段。页上同时存在这两组表述,本文只如实并列,不自行判断现在实际还会不会返回性别和地区,也不把公告或字段表单独写成已经替代另一处。

两页还写:当开发者在网页中不规范使用发起「snsapi_userinfo」网页授权时,微信将默认打开网页快照页模式进行基础浏览,能力调整已于 2022 年 7 月 12 日 24 时生效。换取 Token 的返回参数中有「is_snapshotuser」,说明只有当用户是快照页模式虚拟账号时返回,值为 1。这与作用域差异相关,但不是「两个 scope 是否同一种结果」的全部答案,本文不展开快照页的处理步骤。

核对时不要把授权结果、弹窗例外和域名配置混成一步

要判断「snsapi_base」和「snsapi_userinfo」拿到的是不是同一种结果,可以按官方已经写出的层次来核对。

第一,目前网页授权有两个 scope,不是同一套结果:前者静默跳转,主要获取 openid 等信息,无法获取昵称头像,也无须再调用拉取用户信息的接口;后者用于获取用户基本信息,并可在作用域为「snsapi_userinfo」时拉取用户信息,unionid 也只在这一作用域下返回。

第二,「snsapi_userinfo」并不等于每一次都会弹窗。已关注用户从本服务号的会话或自定义菜单进入网页授权页时,官方写的是静默授权;其他情况下,点击跳转会拉起弹窗,直接跳转则可能进入快照页提示。可选参数「forcePopup」在命中特殊场景下的静默授权逻辑时不生效。

第三,服务号文档与并行页对适用账号、特殊补充和 UnionID 范围的表述不完全相同,应以各自页标日期下的原文并列核对,不要合成一种更完整的说法。

第四,页首已写明不再返回用户性别及地区信息,但参数表和拉取用户信息字段说明仍出现性别、所在地或相应字段,二者并存,不在未做实测时改写成单一结论。

第五,网页授权域名、redirect_uri 和 10003 是另一类核对,不在本题展开;也不把网页授权理解成可以强制跳转或绕过拦截。

本文依据的是 2026年11月21日(北京时间)阅读的上述两份公开文档,未登录公众平台或开放平台后台,也未发起实际授权。页上未写明的字段是否仍返回、特殊静默场景的完整名单,以及第三方工具是否接入该能力,都仍未核实。最终只能以当时页面已经写出的作用域说明为准。

参考资料

微信网页授权 https://developers.weixin.qq.com/doc/service/guide/h5/auth.html (页标最后一次编辑于 2026-07-04,2026年11月21日北京时间阅读)

网页应用授权登录 https://developers.weixin.qq.com/doc/oplatform/developers/dev/auth/h5.html (页标最后一次编辑于 2026-05-27,2026年11月21日北京时间阅读)

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