AppID、UnionID 和 OpenID 分不清楚？

summary: 微信开放平台、微信公众平台、微信小程序、AppID、UnionID 以及 OpenID 搞得人头大

tags: 前端、微信开放平台、微信公众平台、微信小程序、AppID、UnionID、OpenID

author: 大熊

目前互联网应用的推广和传播都离不开微信，进而了解微信相关生态十分重要，本文主要带领大家一起梳理一下微信生态下的 微信开放平台、微信公众平台、微信小程序、AppID、UnionID 以及 OpenID，从此让你明明白白做人。

微信公众平台（OpenID）

1. 会给微信用户生成 OpenID；
2. 不管是 微信公众号 还是 微信小程序，二者都是在微信公众平台进行管理的，所以他俩就放一起讲，为了识别用户，每个微信用户针对每个 公众号 或者 小程序 会产生一个安全的 OpenID；

举个🌰

你们公司有

3 个公众号：公众号A、公众号B、公众号C；

3 个小程序：小程序A、小程序B、小程序C；

那么针对同一微信用户，这六个平台会分别为这个用户各生成一个唯一的 OpenID；

看起来是这样的👇🏻：

公众号A 👉 微信用户A 👉 OpenID_1

公众号B 👉 微信用户A 👉 OpenID_2

公众号C 👉 微信用户A 👉 OpenID_3

小程序A 👉 微信用户A 👉 OpenID_4

小程序B 👉 微信用户A 👉 OpenID_5

小程序C 👉 微信用户A 👉 OpenID_6

微信开放平台（UnionID）

1. 会给微信用户生成 UnionID；
2. 为了识别用户，每个微信用户针对每个 微信开放平台 会产生一个安全的 UnionID；

举个🌰

你们公司由于业务广泛，同时也开发了三个原生应用：App_A、App_B、App_C；

这三个 App 都需要做微信授权登录，你们就需要将这三个 App 绑定到一个微信开放平台下（同一个开放平台）；

那么针对同一微信用户，这个微信开放平台会为这个用户生成一个唯一的 UnionID。

❗️❗️❗️敲黑板：

1. 同一微信用户在 App_A、App_B、App_C 下的 UnionID 是同一个，因为这 3 个 App 绑定在同一个开放平台下；
2. 由于 App 是直接绑定在微信开放平台下，所以开放平台同时也会为 3 个 App 的同一用户分别生成 3 个 OpenID；

看起来是这样的👇🏻：

App_A 👉 微信用户A 👉 OpenID_7 👉 UnionID_1

App_B 👉 微信用户A 👉 OpenID_8 👉 UnionID_1

App_C 👉 微信用户A 👉 OpenID_9 👉 UnionID_1

如果需要在多公众号、小程序、移动应用之间做用户共通，则需前往微信开放平台，将这些公众号和应用绑定到一个开放平台账号下，绑定后一个用户虽然对多个公众号和移动应用有多个不同的 OpenID，但他对所有这些同一开放平台账号下的公众号和应用，只有一个 UnionID。

此时，看起来是这样的👇🏻：

公众号A 👉 微信用户A 👉 OpenID_1 👉 UnionID_1

公众号B 👉 微信用户A 👉 OpenID_2 👉 UnionID_1

公众号C 👉 微信用户A 👉 OpenID_3 👉 UnionID_1

小程序A 👉 微信用户A 👉 OpenID_4 👉 UnionID_1

小程序B 👉 微信用户A 👉 OpenID_5 👉 UnionID_1

小程序C 👉 微信用户A 👉 OpenID_6 👉 UnionID_1

App_A 👉 微信用户A 👉 OpenID_7 👉 UnionID_1

App_B 👉 微信用户A 👉 OpenID_8 👉 UnionID_1

App_C 👉 微信用户A 👉 OpenID_9 👉 UnionID_1

AppID

另外插一嘴，还有一个东西叫 AppID，此时你的心情可能是 woc 它又是个什么鬼呢？？？

还是拿你们公司来说吧，目前你们公司有 3 个公众号、3 个小程序、3 个 App ，暂且把它们理解为 9 个不同的应用，那么 AppID 分别就是这 9 个不同应用的唯一标识；

说人话：

• 通过微信公众平台注册一个 公众号A，那么 公众号A 就有一个自己的唯一标识 AppID_1；
• 通过微信公众平台注册一个 小程序A，那么 小程序A 就有一个自己的唯一标识 AppID_4；
• 通过微信开放平台绑定一个 App_A，那么 App_A 就有一个自己的唯一标识 AppID_7；

看起来是这样的👇🏻：

公众号A 👉 AppID_1 👉 微信用户A 👉 OpenID_1 👉 UnionID_1

公众号B 👉 AppID_2 👉 微信用户A 👉 OpenID_2 👉 UnionID_1

公众号C 👉 AppID_3 👉 微信用户A 👉 OpenID_3 👉 UnionID_1

小程序A 👉 AppID_4 👉 微信用户A 👉 OpenID_4 👉 UnionID_1

小程序B 👉 AppID_5 👉 微信用户A 👉 OpenID_5 👉 UnionID_1

小程序C 👉 AppID_6 👉 微信用户A 👉 OpenID_6 👉 UnionID_1

App_A 👉 AppID_7 👉 微信用户A 👉 OpenID_7 👉 UnionID_1

App_B 👉 AppID_8 👉 微信用户A 👉 OpenID_8 👉 UnionID_1

App_C 👉 AppID_9 👉 微信用户A 👉 OpenID_9 👉 UnionID_1

相信你已经发现端倪了吧，mou 错：

• AppID 对应 平台应用
• OpenID 和 UnionID 对应 用户

你也可以这么理解，对于 同一用户，一个平台应用的 AppID 就会为他生成一个对应的 OpenID，如果这些平台应用都绑定在同一个 微信开放平台 下，那么这个用户的这些 OpenID 都会对应同一个 UnionID；

OpenID 和 UnionID 如何处理

1. AppID 是不需要我们存储的，准确来说 它不属于用户数据；
2. 但是 OpenID 和 UnionID 就属于用户数据了，是需要作为用户信息进行存储的；

怎么存储❓❓❓

首先我们已经知道了 UnionID 和 OpenID 是一对多的关系， 同一个开放平台下的多个应用对于同一微信用户所生成的 UnionID 是一致的， 所以 UnionID 就和我们在用户表里给注册用户生成的 userID 一样，可以作为用户的唯一标识， 但是同一用户分别在多端（小程序、App）登录时的 OpenID 却是多个， 此时我们就要通过不同端（小程序、App）的标识来把这几个不同的 OpenID 区分开来关联到 UnionID 和 userID 上， 也就是一条用户信息里会包含有：1 个 userID、1 个 UnionID、多个可以区分开来的 OpenID；

有人可能会说了，有 UnionID 就行了，为啥还要存储这个不能作为唯一标识的 OpenID 呢，那我来告诉你吧，主要就以下几点：

1. 微信 SDK 的某些 api 可能会用到 OpenID 作为参数；
2. 之前，OpenID 的获取不需要用户授权就能拿到，但是 UnionID 的获取就需要用户授权同意了之后才能获取到，你不能排除公司的某些业务为了缩短流程链路，不想进行用户授权，所以这个时候就需要用 OpenID 作为当前平台用户的唯一标识来使用了；
3. 补充一点：现在微信对 UnionID 的获取做了调整，无需授权也可以直接获取到了；
4. 还有最重要一点，涉及到开放平台主体迁移的时候，OpenID 可是能派上大用场，往下看👇🏻；

微信公众号主体迁移

具体流程本文不细讲，可查看官方提供的文档：

🔗 微信官方提供的公众号主体迁移条件及流程文档

🔗 https://kf.qq.com/product/weixinmp.html#hid=2488

❗️❗️❗️主要强调一些注意事项：

1. 需要用新主体注册一个新的公众号作为目标主体公众号；
2. AppID 会变，所有涉及到的业务逻辑都要变更；
3. AppSecret 会变，所有涉及到的业务逻辑都要变更；
4. OpenID 会变，但是官方提供了接口，可以将老的 OpenID 映射到新的 OpenID，以供开发者做数据变更 🔗 OpenID 转换接口 🔗 https://kf.qq.com/faq/1901177NrqMr190117nqYJze.html；
5. 迁移完成后，用户扫描原账号的二维码会自动跳转到目标账号关注页面，目前仅支持普通二维码的跳转，带参数二维码暂不支持跳转；
6. 只要不涉及到微信开放平台的主体变更，UnionID 就不会变，相关业务逻辑也可以正常使用；

微信小程序主体迁移

具体流程本文不细讲，可查看官方提供的文档：

🔗 微信官方提供的小程序主体迁移条件及流程文档

🔗 https://kf.qq.com/product/wx_xcx.html#hid=2790

❗️❗️❗️主要强调一些官方文档没说的注意事项：

1. AppID 不会变，所以之前生成的 小程序二维码、小程序码 都可以继续使用；
2. AppSecret 不会变，所以服务端之前写的涉及到微信的接口都可以继续使用；
3. OpenID 不会变，所以之前有关 OpenID 的业务逻辑也可以继续使用；
4. 只要不涉及到微信开放平台的主体变更，UnionID 就不会变，相关业务逻辑也可以正常使用；

微信开放平台主体迁移

具体流程本文不细讲，可查看官方提供的文档：

🔗 微信官方提供的开放平台主体迁移条件及流程文档

🔗 https://kf.qq.com/faq/170811F3aAjM170811zme6rq.html

❗️❗️❗️主要强调一些注意事项：

1. 需要用新主体注册一个新的开放平台作为迁入开放平台，且需要完成认证；
2. 开放平台仅支持 移动/网站应用 迁移;
3. 绑定在原开放平台的 App 的 AppID 不会变，可继续使用；
4. AppSecret 不会变，可继续使用；
5. UnionID 会变，需要提前做好相关数据映射；
6. OpenID 不会变，可继续使用；

可以看出，小程序 和 公众号 的迁移，都没有涉及 UnionID 的变更，但是 开放平台 的迁移，就涉及到 UnionID 的变更了，UnionID 作为多平台关联的唯一标识，如何处理至关重要，由于微信官方并没有提供具体 api 来做数据映射，所以我们开发者只能自行处理了，以下提供一个比较好的方案来映射新老 UnionID：

1. 迁移完成后，我们之前的微信授权登录接口肯定是要做相应的改动；
2. 用户在 App端 或者 小程序端 使用微信授权登录时，我们可以拿到 OpenID（没变，老的） 和 UnionID（变了，新的）；
3. 首先用 UnionID 去用户信息表里查找，如果匹配不到用户数据，那就说明他有可能是新注册用户，也有可能是没有做过 老 UnionID 映射 新 UnionID 的老用户；
4. 此时不能区分出来这两者，所以我们还需要用 OpenID 来判断，如果通过 OpenID 在用户信息表里能查找用户数据，就说明他是老用户，此时我们需要用新的 UnionID 替换掉表里老的 UnionID 即可；
5. 如果用 OpenID 也没有在用户信息表里查找到数据，那就说明他是个新注册用户，正常存储 OpenID 和 UnionID 即可；

总结

以上总结的经验基本都是我踩过的坑，可谓一本🩸💦💩，提供出来希望能给大家带来一点帮助， 相信能看到这里的朋友，一定对 微信开放平台、微信公众平台、微信小程序、AppID、UnionID 以及 OpenID 之间的关系有一个清晰的认知了，如果还是有疑问，欢迎留言讨论~