1. 微信小程序用户授权:从登录到获取手机号的完整旅程
做小程序开发,尤其是涉及到用户身份和敏感信息时,授权流程绝对是绕不开的核心环节。很多刚入门的开发者朋友一看到 openid、session_key、encryptedData、iv 这些名词就有点发怵,感觉流程复杂,安全风险高。别担心,今天我就以一个过来人的身份,把微信小程序里这套从用户登录到安全获取手机号的完整流程,掰开了、揉碎了讲给你听。这就像一次精心设计的“握手”仪式,每一步都有其目的和规矩,理解透了,你不仅能顺畅实现功能,更能有效规避各种潜在的安全“坑”。
简单来说,整个过程可以看作两个核心阶段。第一阶段是“身份确认”:用户在小程序里点一下登录,我们拿到一个临时的“门票”(code),然后用这张门票去微信服务器换回用户的唯一身份证(openid)和一把重要的“会话钥匙”(session_key)。第二阶段是“信息获取”:当用户同意授权手机号时,小程序前端会拿到一个加密的数据包,我们需要用第一阶段得到的那把“钥匙”,配合一些参数,在服务端安全地解开这个数据包,最终拿到用户的手机号码。听起来是不是清晰多了?接下来,我们就一步步深入,看看每个环节具体怎么操作,又有哪些必须注意的安全细节。
2. 第一步:获取用户的“身份证”和“会话钥匙”
万事开头难,但第一步走稳了,后面就顺了。这个阶段的目标是拿到两个核心数据:openid 和 session_key。openid 你可以理解为用户在你这个小程序里的唯一身份证号,同一个微信用户在不同的小程序里,openid 是不同的。而 session_key 则是本次登录会话的加密密钥,它是后续解密用户敏感信息(如手机号)的关键,必须像保护密码一样保护它,绝不能泄露给前端或客户端。
2.1 前端发起登录:获取临时凭证 code
一切的起点,是用户打开你的小程序。你需要在合适的时机(比如应用启动时、检测到未登录状态时)调用微信的 wx.login() 接口。这个接口非常快,它会在用户无感的情况下,向微信服务器申请一个临时的登录凭证 code。这个 code 有效期只有5分钟,且一次性使用。
// 小程序端示例代码
wx.login({
success(res) {
if (res.code) {
// 这个 code 就是我们要传到服务端的临时凭证
console.log('获取到的登录code:', res.code);
// 接下来,你需要将这个 code 通过网络请求发送给自己的服务器
wx.request({
url: 'https://你的服务器域名/api/login',
method: 'POST',
data: {
code: res.code
},
success(loginRes) {
// 服务端处理成功后,通常会返回一个自定义的登录态token给前端
console.log('登录成功', loginRes.data);
}
});
} else {
console.log('登录失败!' + res.errMsg);
}
}
});
看到没?前端的工作很简单,就是拿到 code 然后传给自己的后端服务。这里有个小经验:wx.login 不需要用户授权,它是静默发生的,所以你可以把它放在 app.onLaunch 里自动执行,尽早建立用户身份。
2.2 服务端兑换 openid 和 session_key
前端把 code 传过来了,后端的工作就开始了。你的服务器需要拿着这个 code,再加上小程序的 AppID 和 AppSecret(这两个都在微信公众平台后台获取),去访问微信的接口换取真实信息。
微信提供的接口地址是:https://api.weixin.qq.com/sns/jscode2session。你需要发起一个 HTTPS GET 请求,带上三个必要参数:
appid: 你的小程序IDsecret: 你的小程序密钥(AppSecret)js_code: 前端传过来的那个临时codegrant_type: 固定填写authorization_code
下面我用一个更健壮、更现代的 Java 示例(使用 Spring Boot 和 RestTemplate)来展示这个过程,这比我之前看到的直接用 HttpClient 的代码更清晰,也更容易处理异常。
import org.springframework.beans.factory.annotation.Value;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
@Service
public class WeChatAuthService {
@Value("${wechat.appid}")
private String appId;
@Value("${wechat.secret}")
private String appSecret;
private static final String JSCODE2SESSION_URL = "https://api.weixin.qq.com/sns/jscode2session";
3416



被折叠的 条评论
为什么被折叠?



