微信小程序 OpenId、UnionId

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

文章目录

1. OpenId1.1 概念1.2 公众号OpenId（简称 wxopenid）==同一个微信用户在小程序和公众号上的openid是不同的==

1.3 openid的获取方式方式1. 调用wx.login接口获取openid方式2. 登录授权获取openid

1.4 openid的作用1.5 openid的注意事项

2. UnionId2.1 概念2.2 唯一性说明同一用户，对同一个微信开放平台下的不同应用，unionid是相同的

2.3 获取 UnionId 流程：

1. OpenId

1.1 概念

OpenId 是一个用户对于一个小程序／公众号的标识，开发者可以通过这个标识识别出用户。类似 wxopenid，

在微信小程序中，openid是唯一标识一个用户的字符串，是用户在小程序中的身份证明。

同一个人，使用不同的小程序，会留下不同的小程序 OpenId 。获取小程序 OpenId 无需用户操作和授权。

1.2 公众号OpenId（简称 wxopenid）

在小程序中，openID是小程序的普通用户的一个唯一的标识，只针对当前的小程序有效同理在公众号中openID是公众号的普通用户的一个唯一的标识，只针对当前的公众号有效以上所有 ID 均并不包含敏感信息，只是个普通的 ID。

同一个微信用户在小程序和公众号上的openid是不同的

同一个人，关注不同的公众号，会留下不同的wxopenid。大帐号、小帐号因为绑定在一起了，所以会是同一个wxopenid。同一个用户，在同主体的小程序和公众号下，会有各自的 OpenId ，不相同，不能混用。

1.3 openid的获取方式

在小程序中，获取openid的方式有两种：调用wx.login接口获取临时登录凭证code，再通过code向服务器换取openid；或者通过登录授权的方式获取用户信息，其中包括openid。

方式1. 调用wx.login接口获取openid

调用wx.login接口获取临时登录凭证code，再将code发送到服务器后台进行处理，最终获得openid。

wx.login({

success(res) {

if (res.code) {

wx.request({

url: 'https://api.weixin.qq.com/sns/jscode2session',

data: {

appid: 'your_appid',

secret: 'your_secret',

js_code: res.code,

grant_type: 'authorization_code'

},

success(res) {

console.log(res.data.openid)

}

})

} else {

console.log('登录失败！' + res.errMsg)

}

}

})

前端获取到 code 后，将 code 传给后端，后端调用接口获取 session_key 和 OpenId

方式2. 登录授权获取openid

在小程序中，可以使用wx.getUserInfo接口获取用户信息，其中包括用户的openid。

wx.getUserInfo({

success(res) {

console.log(res.userInfo)

console.log(res.userInfo.nickName)

console.log(res.userInfo.avatarUrl)

console.log(res.userInfo.openId)

}

})

1.4 openid的作用

1.5 openid的注意事项

2. UnionId

2.1 概念

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

如果开发者拥有多个移动应用、网站应用、和公众帐号（包括小程序），可通过 UnionID 来区分用户的唯一性，因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号（包括小程序），用户的 UnionID 是唯一的。换句话说，同一用户，对同一个微信开放平台下的不同应用，unionid是相同的。简而言之，unionid是用来说明多个应用下用户身份一致性的问题。相比较而言，由于在同一个应用下每个用户的openid是唯一的，因此openid也是也可以用来标记用户身份，但是仅限于在同一个应用中。对于不同的应用，每个用户的openid是不一样的，要想在不同应用间识别用户的唯一性只可以用unionid。

2.2 唯一性说明

同一用户，对同一个微信开放平台下的不同应用，unionid是相同的

一个人，在同主体的小程序、公众号等下面只有 1 个 UnionId，有多个 wxopenid 和多个小程序OpenId 。 UnionId是同主体应用下唯一身份证，可以查询对应的wxopenid和小程序OpenId。因此，UnionId 的覆盖率是最高的。当用户关注公众号、逛公众号下面H5时，可以同时获取 UnionId、wxopenid。而逛小程序时，可以同时获取小程序 UnionId、openid。不管逛哪都能拿到 UnionId。 在单个小程序或公众号里，OpenId 是唯一的。当同一个小程序主体下有多个小程序时，每个小程序有自己的 OpenId，因此需要 UnionId 进行唯一身份标识，即：UnionId 是同个主体下不同小程序的用户唯一标识；

2.3 获取 UnionId 流程：

前提条件：

微信开放平台帐号已完成开发者资质认证微信开放平台绑定小程序

获取 UnionId 流程：

调用接口 wx.getUserInfo ，从解密数据中获取 UnionID。注意本接口需要用户授权，请开发者妥善处理用户拒绝授权后的情况。如果开发者帐号下存在同主体的公众号，并且该用户已经关注了该公众号。开发者可以直接通过 wx.login + code2Session 获取到该用户 UnionID，无须用户再次授权。如果开发者帐号下存在同主体的公众号或移动应用，并且该用户已经授权登录过该公众号或移动应用。开发者也可以直接通过 wx.login + code2Session 获取到该用户 UnionID ，无须用户再次授权。用户在小程序（暂不支持小游戏）中支付完成后，开发者可以直接通过 getPaidUnionId 接口获取该用户的 UnionID，无需用户授权。注意：本接口仅在用户支付完成后的5分钟内有效，请开发者妥善处理。小程序端调用 云函数 时，如果开发者帐号下存在同主体的公众号，并且该用户已经关注了该公众号，可在云函数中通过 cloud.getWXContext 获取 UnionID。小程序端调用 云函数 时，如果开发者帐号下存在同主体的公众号或移动应用，并且该用户已经授权登录过该公众号或移动应用，也可在云函数中通过 cloud.getWXContext 获取 UnionID。

参看文档： UnionID 机制说明 | 微信开放文档 微信开发者平台文档 https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/union-id.html

推荐链接

 您阅读本篇文章共花了：