媒体报道

微信账户体系科普：什么是 UnionId、OpenId 与 wxopenid？原文标题：微信账户体系科普：什么是UnionId、OpenId与wxopenid？ – 人人都是产品经理

发表时间：（页面未标注）采集时间：2026-10-09 10:49:11来源：www.woshipm.com原文语言：zh状态：完整

原始链接：https://www.woshipm.com/pd/3707175.html

内容概要总结

本文由「龙村后生」发布于人人都是产品经理，科普微信账户体系中 UnionId、OpenId、wxopenid 三个概念的区别与获取方式。概念解释：小程序 OpenId 是用户对某一个小程序/公众号的标识，同一人使用不同小程序会留下不同 OpenId，获取无需授权；UnionId 是用户对同一主体下微信小程序/公众号/APP 的标识，需在微信开放平台绑定相同主体账号，可实现多小程序、公众号甚至 APP 之间的数据互通；公众号 OpenId（wxopenid）同一人关注不同公众号不同，但大号小号绑定在一起则为同一个。唯一性说明：一个人在同主体小程序、公众号下只有 1 个 UnionId，有多个 wxopenid 和多个小程序 OpenId，因此 UnionId 覆盖率最高。获取方式给出 wx.login 取 code、后端调 jscode2session 换 session_key 与 OpenId、以及 wx.getUserInfo、getPaidUnionId、cloud.getWXContext 等途径。

原文内容（原文即中文）

⚠ 说明：正文经抽取后剔除站点作者信息与推荐位，仅保留文章主体。

微信账户体系科普：什么是UnionId、OpenId与wxopenid？

龙村后生

1 评论

39515 浏览

66 收藏

6 分钟

如果你对 UnionId、OpenId、wxopenid这三个概念傻傻分不清，那看这篇文章就对了。了解微信账户体系，能帮助你更好地做小程序设计。

01 概念解释

1. 小程序OpenId

OpenId 是一个用户对于一个小程序／公众号的标识，开发者可以通过这个标识识别出用户。类似 wxopenid，同一个人，使用不同的小程序，会留下不同的小程序 OpenId 。获取小程序 OpenId 无需用户操作和授权。

2. UnionId

UnionId 是一个用户对于同主体微信小程序／公众号／APP的标识，开发者需要在微信开放平台下绑定相同账号的主体。开发者可通过 UnionId，实现多个小程序、公众号、甚至APP 之间的数据互通。

正常情况下，微信生态中，UnionId 是用户身份的唯一标识，（如果业务涉及不同主体，不一定）。

所以，如果开发者拥有多个移动应用、网站应用、和公众帐号（包括小程序），可通过 UnionId 来区分用户的唯一性。

3. 公众号OpenId（简称 wxopenid）

同一个人，关注不同的公众号，会留下不同的wxopenid。大帐号、小帐号因为绑定在一起了，所以会是同一个wxopenid。

同一个用户，在同主体的小程序和公众号下，会有各自的 OpenId ，不相同，不能混用。

以上，所有 ID 均并不包含敏感信息，只是个普通的 ID。

02 唯一性说明

一个人，在同主体的小程序、公众号等下面只有 1 个 UnionId，有多个 wxopenid 和多个小程序OpenId 。

UnionId是同主体应用下唯一身份证，可以查询对应的wxopenid和小程序OpenId。因此，UnionId 的覆盖率是最高的。当用户关注公众号、逛公众号下面H5时，可以同时获取 UnionId、wxopenid。而逛小程序时，可以同时获取小程序 UnionId、openid。不管逛哪都能拿到 UnionId。

在单个小程序或公众号里，OpenId 是唯一的。当同一个小程序主体下有多个小程序时，每个小程序有自己的 OpenId，因此需要 UnionId 进行唯一身份标识，即：UnionId 是同个主体下不同小程序的用户唯一标识；

03 获取方式

1. wxopenid

2. OpenId

通过调用 wx.login() ，获取临时登录凭证凭证 code

App({
 onLaunch: function() {
 wx.login({
 success: function(res) {
 if (res.code) {
 //发起网络请求
 // code: 就是登录凭证（code)
 }
 }
 });
 }
})

前端获取到 code 后，将 code 传给后端，后端调用接口获取 session\_key 和 OpenId ，接口如下：

https://api.weixin.qq.com/sns/jscode2session?appid=APPID&secret=SECRET&js_code=JSCODE&grant_type=authorization_code

3. UinionId

调用接口 wx.getUserInfo ，从解密数据中获取 UnionID。注意本接口需要用户授权，请开发者妥善处理用户拒绝授权后的情况。

如果开发者帐号下存在同主体的公众号，并且该用户已经关注了该公众号。开发者可以直接通过 wx.login + code2Session 获取到该用户 UnionID，无须用户再次授权。

如果开发者帐号下存在同主体的公众号或移动应用，并且该用户已经授权登录过该公众号或移动应用。开发者也可以直接通过 wx.login + code2Session 获取到该用户 UnionID ，无须用户再次授权。

用户在小程序（暂不支持小游戏）中支付完成后，开发者可以直接通过 getPaidUnionId 接口获取该用户的 UnionID，无需用户授权。注意：本接口仅在用户支付完成后的5分钟内有效，请开发者妥善处理。

小程序端调用云函数时，如果开发者帐号下存在同主体的公众号，并且该用户已经关注了该公众号，可在云函数中通过 cloud.getWXContext 获取 UnionID。

小程序端调用云函数时，如果开发者帐号下存在同主体的公众号或移动应用，并且该用户已经授权登录过该公众号或移动应用，也可在云函数中通过 cloud.getWXContext 获取 UnionID。

本文由 @龙村后生原创发布于人人都是产品经理，未经许可，禁止转载

更多精彩内容，请关注人人都是产品经理微信公众号或下载App