소스 검색

feat(auth): 测试模式 silent-login 固定 openid(code 传手机号 → phone:<号码>)

- WechatService.code2Session test-mode 分支:code 形如手机号(^1[3-9]\d{9}$)时
  openid 固定为 phone:<号码>,与 phone-login 建号 openid 约定一致
- silent-login 传同一号码可稳定命中同一账号,自动化测试可复用登录态
- 非手机号 code 保持原随机 test_openid_<uuid> 行为,不破坏既有 mock 用例
- 零契约/DB/前端改动;设计文档 docs/superpowers/specs/2026-10-30-silent-login-fixed-openid-design.md
iwt 2 주 전
부모
커밋
21074da365

+ 9 - 1
cfc-backend/src/main/java/com/etotem/cfc/service/WechatService.java

@@ -131,7 +131,15 @@ public class WechatService implements WechatServiceInterface {
         if (testMode) {
             log.info("测试模式:模拟code2Session返回");
             Map<String, String> result = new HashMap<>();
-            result.put("openid", "test_openid_" + UUID.randomUUID().toString().substring(0, 8));
+            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;

+ 118 - 0
docs/superpowers/specs/2026-10-30-silent-login-fixed-openid-design.md

@@ -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 迁移。