|
|
@@ -0,0 +1,118 @@
|
|
|
+# 测试模式 silent-login 固定 openid 设计
|
|
|
+
|
|
|
+- 日期:2026-10-30
|
|
|
+- 分支:`feature/silent-login-fixed-openid-test`
|
|
|
+- 源码基线:`origin/cfclub` @ `d8687f7c8`
|
|
|
+- 类型:行为修复(仅 test-mode,不影响生产行为)
|
|
|
+
|
|
|
+## 背景
|
|
|
+
|
|
|
+当前部署的 `cfc-backend`(192.168.16.251 测试环境,9082)是自动化测试环境:
|
|
|
+
|
|
|
+- `admin.skip-captcha: true`(后台登录不校验验证码)
|
|
|
+- `wechat.test-mode: true`(跳过微信 API,验证码接受固定码 `123456`)
|
|
|
+- profile 为 `default`,未加载 `application-prod.yml`
|
|
|
+
|
|
|
+问题:`silent-login`(`POST /api/auth/silent-login`)在测试模式下不可用。
|
|
|
+
|
|
|
+调用链:
|
|
|
+`AuthController.silentLogin` → `UserService.silentLogin(code)` → `WechatService.code2Session(code)`
|
|
|
+
|
|
|
+`code2Session` 在 test-mode 下返回**随机** openid:
|
|
|
+`test_openid_ + UUID.randomUUID().substring(0, 8)`
|
|
|
+
|
|
|
+而 `silentLogin` 通过 `User::getOpenid == openid` 查找用户。每次随机 → 永远查不到
|
|
|
+(`phone-login` 建的账号 openid 是 `phone:<手机号>` 约定)→ 恒返回
|
|
|
+`用户不存在,请先登录`。
|
|
|
+
|
|
|
+由此自动化测试每次静默续期都失败,且 `wechatLogin` 每次用随机 openid 反复新建账号,
|
|
|
+产生脏数据。
|
|
|
+
|
|
|
+## 目标(G)
|
|
|
+
|
|
|
+1. test-mode 下,调用方在 `code` 字段传手机号时,`code2Session` 返回**固定** openid:
|
|
|
+ `phone:<手机号>`。
|
|
|
+2. 同一号码多次调用 silent-login 命中同一账号,登录态可复用。
|
|
|
+3. 不改 API 契约、不改 DTO、不改前端、不做 DB 迁移。
|
|
|
+4. 非手机号格式的 code 保持原有随机 mock 行为(不破坏既有用例)。
|
|
|
+
|
|
|
+## 非目标(NG)
|
|
|
+
|
|
|
+- 不改生产(`test-mode=false`)路径的任何行为。
|
|
|
+- 不做 silent-login 自动注册账号(账号须先经 `phone-login` 注册)。
|
|
|
+- 不新增 `phone` 请求字段、不改 `WechatLoginDTO` / `UserService` 签名。
|
|
|
+- 不动部署实例配置。
|
|
|
+
|
|
|
+## 方案选择
|
|
|
+
|
|
|
+| 方案 | 做法 | 取舍 |
|
|
|
+|------|------|------|
|
|
|
+| A. code 承载号码(选定) | test-mode 下 code2Session 检测 `^1[3-9]\d{9}$`,mock openid = `phone:<code>` | 零契约改动、与既有 `phone:` openid 约定完全一致;真实微信 code 为不透明字符串、不可能形如手机号,判定安全 |
|
|
|
+| B. DTO 新增 phone 字段 | silent-login 显式传号码 | 需改 DTO + Service 签名;小程序侧本地未存手机号,前端还要补存补传 |
|
|
|
+| C. 显式 hash(code) 为 openid | `test_openid_<md5(code)>` | 稳定但命中不了 `phone:` 前缀的既有账号,仍无法复用登录态 |
|
|
|
+
|
|
|
+## 详细设计
|
|
|
+
|
|
|
+### 改动点(唯一)
|
|
|
+
|
|
|
+`cfc-backend/src/main/java/com/etotem/cfc/service/WechatService.java`
|
|
|
+方法 `code2Session(String code)` 的下列分支:
|
|
|
+
|
|
|
+```java
|
|
|
+// 测试模式:返回模拟的openid
|
|
|
+if (testMode) {
|
|
|
+ log.info("测试模式:模拟code2Session返回");
|
|
|
+ Map<String, String> result = new HashMap<>();
|
|
|
+ String openid;
|
|
|
+ // 测试模式:code 传手机号时 openid 固定为 phone:<号码>,与 phone-login 建号的 openid
|
|
|
+ // 约定一致,使 silent-login 能稳定命中同一账号,便于自动化测试复用登录态。
|
|
|
+ if (code != null && code.matches("^1[3-9]\\d{9}$")) {
|
|
|
+ openid = "phone:" + code;
|
|
|
+ } else {
|
|
|
+ openid = "test_openid_" + UUID.randomUUID().toString().substring(0, 8);
|
|
|
+ }
|
|
|
+ result.put("openid", openid);
|
|
|
+ result.put("session_key", "test_session_key");
|
|
|
+ result.put("unionid", "");
|
|
|
+ return result;
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+### 行为流(测试模式)
|
|
|
+
|
|
|
+1. 注册/首登:`POST /api/auth/phone-login {"phone":"13900001234","code":"123456"`
|
|
|
+ → `UserService.phoneLogin` 建号,`openid = phone:13900001234`
|
|
|
+2. 静默续期:`POST /api/auth/silent-login {"code":"13900001234"}`
|
|
|
+ → `code2Session` 命中手机号分支 → `openid = phone:13900001234`
|
|
|
+ → `silentLogin` 查用户成功 → 返回 token(复用同一账号)
|
|
|
+3. 未注册号码:`silent-login {"code":"13800000000"}` → openid = `phone:13800000000`
|
|
|
+ → 查无此人 → 返回 `用户不存在,请先登录`(语义不变)
|
|
|
+4. 非手机号 code(沿用旧用例):openid 随机,行为与改前一致
|
|
|
+
|
|
|
+### 影响面
|
|
|
+
|
|
|
+- `wechatLogin` 同参数(code=手机号)也会得到 `phone:<号码>` openid:openid 已存在则
|
|
|
+ 刷新 sessionKey,否则按手机号/新用户分支创建或绑定,与 phone-login 口径一致,
|
|
|
+ 无回归。
|
|
|
+- `phone:` 前缀 openid 在 `FamilyMemberService.isWechatLoginUser`、
|
|
|
+ `ActivityOrderService`、`ProductOrderService` 已被特殊识别(视为非微信登录用户 /
|
|
|
+ 模拟 openid),语义不变。
|
|
|
+- 数据面:不再每次静默登录新建账号,反而减少脏数据。
|
|
|
+
|
|
|
+## 验证
|
|
|
+
|
|
|
+1. `mvn -pl cfc-backend -am compile` 通过(按 `cfc-backend/AGENTS.md` 约定,
|
|
|
+ 编译通过即视为验证完成,不做运行时/启动验证)。
|
|
|
+2. 重部署后的人工验证脚本(本次不执行,供运维/后续验证使用):
|
|
|
+ - 已注册号码:`phone-login {"phone":"13900001234","code":"123456"}` 成功 →
|
|
|
+ `silent-login {"code":"13900001234"}` 应返回 200 + token,且 `userId` 与
|
|
|
+ phone-login 一致
|
|
|
+ - 未注册号码:`silent-login` 返回 `用户不存在`
|
|
|
+ - 错误码对照:`phone-login` 错误码仍被拒
|
|
|
+ - 注意:`phone-login` 对未注册号码会新建账号,验证后需清理测试数据
|
|
|
+
|
|
|
+## 不做的事
|
|
|
+
|
|
|
+- 不修改 `application.yml` / `application-prod.yml`。
|
|
|
+- 不重启或重部署 9082 实例。
|
|
|
+- 不做 DB 迁移。
|