前言

在小程序开发中，登录功能几乎是每个项目必不可少的一环。即使你并不直接负责登录模块，也必须清楚其工作流程——特别是 openId 与 unionId 的作用。了解这些关键字段后你才能顺利完成后续的使用者数据存储、权限校验等工作。

需求分析

使用者点击“登录”按钮时需要弹出授权窗口，获取使用者手机号并完成登录。常见的痛点包括：

• 授权窗口频繁弹出导致使用者体验差。
• 手机号获取失败率高，导致部分使用者无法完成登录。
• 接口返回错误信息不友好，开发者难还有时定位问题。其实，

思路说明

这篇文章采用微信官方推荐的登录流程。并结合 Spring Boot 后端实现细节进行拆解。主要步骤的观点是，

1. 前端调用 wx.login 获取临时凭证 code
2. 后端调用 换取 openId/unionId/session_key。
3. 若需要手机号。则再调用
4. 根据 openId 判断是否已有账号，若无则新建；若有则更新手机号，最终生成 JWT 并返回给前端。

关键注意点

• 前端依赖：需引入微信 SDK 并在小程序里配置正确的 AppID。
• 后端安全：务必使用 HTTPS 与微信服务器通信。并妥善存储 AppSecret，避免泄露导致被盗用。
• token 管理：建议使用 JWT 进行无状态验证，并在服务器侧对 token 失效时间做合理设置。按理说，

表结构说明

下面给出一份简洁的使用者表，用于存储基本信息与 openId：

CREATE TABLE `family_member` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',`phone` varchar NOT NULL COMMENT '手机号',`name` varchar DEFAULT NULL COMMENT '昵称',`avatar` varchar DEFAULT NULL COMMENT '头像',`open_id` varchar DEFAULT NULL COMMENT 'OpenID'。
`gender` int DEFAULT NULL COMMENT '性别',`create_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',`update_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',PRIMARY KEY USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;

接口说明

请求参数示例

{
再看"code"，"0e36jkGa1ercRF0Fu4Ia1V3fPD06jkGW","nickName": "微信使用者"。"phoneCode": "13fe315872a4fb9ed3deee1e5909d5af60dfce7911013436fddcfe13f55ecad3"
}

• 代码解释：
• “代码”: 临时登录凭证可直接传给后端。
• “昵称”: 微信默认返回 “微信使用者”，可自行忽略或自定义昵称生成逻辑。
• "phoneCode" 加密后的手机号信息，仅后端可解析为真实手机号。怎么说呢，

响应示例

{
"status":200,"msg":"操作成功","data":{
"token":"eyJhbGciOiJIUzI1NiJ9...","nickName":"好柿开花8915"
}。"operationTime":null
}

小程序环境搭建

必要配置

基础环境说明

• 修改请求方法为本地地址，例如 http://localhost:8080/xxxx/xxxx。从注意来看，如果你的项目部署在服务器上。需要将此处改为正式域名或IP地址，以便与生产环境保持一致；否则可能出现跨域或网络错误导致接口无法访问的问题。

---

---

---

---

---

---

---

请确认以上内容是否满足您的需求。如需进一步细化，请告知，

。

---