有效期： 官方给出的有效期是2小时。而且，微信对这个接口的调用频率限制非常严格。

Ru果你的小程序只是展示一些信息，不需要强关联用户的真实身份，或者你是个人开发者，那么这种模式是Zui稳妥的。它的核心思想是：只要Neng区分出你是谁就行，至于你手机号是多少，我不关心。

不过这里有个坑得提一下。以前我们Ke以用 uni.getUserProfile 直接获取用户的昵称和头像，但现在的微信基础库版本geng新后获取头像和昵称变得越来越严格，甚至返回的是匿名数据。所以现在的“授权登录”geng多是指获取 openid 的过程。

在前端，我们需要引导用户点击按钮，然后调用登录接口。这里的关键在于，我们要把 loginCode 安全地送到后端。

后端拿到 loginCode 后要Zuo的事就是“兑换”。咱们来kankan Java 是怎么处理的。

@RestController
@RequestMapping
public class WxUserController {
    @PostMapping
    public Result wxLogin {
        String loginCode = params.get;
        // 1. 准备你的 AppID 和 Secret
        String appId = "wxd00000000000"; 
        String secret = "你的Secret密钥";
        // 2. 拼接请求微信的 URL
        String sessionUrl = "https://api.weixin.qq.com/sns/jscode2session?appid=" + appId
                + "&secret=" + secret
                + "&js_code=" + loginCode
                + "&grant_type=authorization_code";
        // 3. 发起 HTTP 请求
        RestTemplate restTemplate = new RestTemplate;
        String responseJson = restTemplate.getForObject;
        // 4. 解析返回的 JSON
        JSONObject sessionData = JSONObject.parseObject;
        String openid = sessionData.getString;
        // String sessionKey = sessionData.getString; // 暂时用不到，但Zui好存起来
        // 5. 业务逻辑：判断用户是否存在
        // 假设我们查数据库，发现没有这个 openid
        // User user = userService.findByOpenid;
        // if  { user = userService.register; }
        // 6. 生成 JWT Token 并返回
        String token = JwtUtil.createToken;
        return Result.success;
    }
}

你kan，基础的授权登录其实并不复杂，核心就是那个 jscode2session 接口。

Ru果你Zuo的是电商、或者需要精准营销的小程序，光有 openid 是不够的。你肯定需要用户的真实手机号来发短信、Zuo客服联系。这时候，就需要用到手机号快速验证功Neng。

这里有个硬性门槛，大家得心里有数：微信小程序的 getPhoneNumber 接口仅对“非个人主体”且“Yi完成微信认证”的小程序开放。个人开发者账号是无法使用此功Neng的，这是微信为了保护用户隐私设定的门槛。

前端不Neng直接拿到手机号，只Neng拿到一个 code。这个 code 就像是一张“手机号兑换券”，需要后端拿去微信服务器兑换。

关键在于 button 组件的 open-type 属性。

后端拿到 phoneCode 后不Neng直接用，必须先拿到 access_token。而这里就是Zui容易出坑的地方：微信对 access_token 的获取有严格的频率限制。Ru果你的用户量一大，每次登录dou去刷新 access_token，你的服务器hen快就会被微信封禁接口，导致全站瘫痪。

所以缓存 是必须的。咱们来写一个带内存缓存和过期管理的 Service 类。

import com.alibaba.fastjson.JSONObject;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;
@Service
public class WxAccessTokenService {
    @Value
    private String appId;
    @Value
    private String secret;
    // --- 内存缓存的核心 ---
    private String cachedAccessToken;
    private long expireTime; // 过期时间点
    /**
     * 获取 access_token 的主入口
     * 使用 synchronized 防止并发请求导致重复刷新
     */
    public synchronized String getAccessToken {
        // Ru果缓存存在且未过期，直接返回
        if  @RestController
@RequestMapping
public class WxUserController {
    @Autowired
    private WxAccessTokenService tokenService;
    @Value
    private String appId;
    @Value
    private String secret;
    @PostMapping
    public Result phoneLogin {
        String phoneCode = dto.getPhoneCode;
        String loginCode = dto.getLoginCode;
        RestTemplate restTemplate = new RestTemplate;
        // --- 第一步：用 loginCode 换取 openid ---
        String sessionUrl = "https://api.weixin.qq.com/sns/jscode2session?appid=" + appId
                + "&secret=" + secret
                + "&js_code=" + loginCode
                + "&grant_type=authorization_code";
        String sessionRes = restTemplate.getForObject;
        JSONObject sessionJson = JSONObject.parseObject;
        String openid = sessionJson.getString;
        System.out.println;
        // --- 第二步：获取缓存的 access_token ---
        String accessToken = tokenService.getAccessToken;
        if  {
            return Result.error;
        }
        // --- 第三步：用 accessToken + phoneCode 换取手机号 ---
        // 注意：这里需要 POST 请求，参数放在 body 里
        String phoneUrl = "https://api.weixin.qq.com/wxa/business/getuserphonenumber?access_token=" + accessToken;
        // 构造请求体
        Map bodyParams = new HashMap<>;
        bodyParams.put;
        // 将 Map 转为 JSON 字符串发送
        String phoneRes = restTemplate.postForObject;
        JSONObject phoneJson = JSONObject.parseObject;
        // --- 第四步：解析结果 ---
        if  == 0) {
            JSONObject phoneInfo = phoneJson.getJSONObject;
            String purePhoneNumber = phoneInfo.getString; // 这就是明文手机号
            String countryCode = phoneInfo.getString;
            System.out.println;
            // --- 第五步：业务注册/登录逻辑 ---
            // 根据 openid 或 手机号 查询用户
            // User user = userService.findByOpenidOrPhone;
            // ...
            return Result.success;
        } else {
            String errMsg = phoneJson != null ? phoneJson.getString : "未知错误";
            System.err.println;
            return Result.error;
        }
    }
}

说了这么多，Zui后咱们来一下。面对这两种模式，到底该怎么选？其实答案hen明确，取决于你的业务阶段和用户体量。

Ru果你是个人开发者，或者你的小程序只是一个工具，不需要强用户体系，那么用 uni.login 获取 openid 就足够了。这种方式开发成本低，用户点击率也高，因为没有什么敏感权限的弹窗。

只要涉及到交易、物流、或者后续需要通过短信触达用户，手机号是必须的。虽然这会增加用户操作的一步，但对于留存和运营来说这是值得的。

在开发过程中，有几个坑我必须再强调一遍，希望Neng帮你省下几个小时的调试时间：

Access Token 的缓存： 千万别每次请求dou去刷新 access_token！一定要Zuo好缓存，Zui好设置一个提前过期的时间，防止在临界点因为网络延迟导致 token 失效。

Code 的时效性： 前端传过来的 loginCode 和 phoneCode dou是临时的。Ru果后端处理太慢，或者网络波动，导致 code 过期了微信会返回错误码。这时候前端需要重新获取 code 再试一次。

测试号限制： Ru果你在开发阶段用的是微信测试号，hen多接口可Neng受限。建议尽早申请正式的小程序账号并进行认证，或者使用真机调试。

微信小程序的登录体系虽然kan起来名词多、流程长，但只要你把它拆解成“前端拿券，后端兑换”这么一个简单的逻辑，一切就豁然开朗了。希望这篇文章Neng帮你彻底搞定这个让人头疼的问题，写出geng优雅的代码！