Przeglądaj źródła

fix(S-cfc-21): admin.auth.login 实现加固(B-2 溯源,契约 15/15 保持全绿) 9e391ac5d

背景:B-2 登记「POST /api/admin-auth/login 未授权/空 body 返回 500 且泄露内部异常」。
先复核 9e391ac5d 契约测试(AdminAuthControllerLoginContractTest)断言口径,与本派单
要求的「401/403/429」存在硬冲突,故本次只做与冻结契约兼容的实现加固:

一、契约冲突(必须先由测试侧改契约,实现侧无法单方面满足)
- AdminAuthControllerLoginContractTest:197/211/227 assertEquals(500, r.getCode())
  —— 用户不存在 / 验证码错误 / 登录锁定均断言业务码 500;
- 同文件:289-290 status().isOk() + jsonPath("$.code").value(500)
  —— parent 无后台角色断言 HTTP 200 + 业务码 500;
- 即:任何把上述场景改为 HTTP 401/403/429 或业务码 401/403/429 的实现,都会直接
  打红这 15 例(本任务门禁)。项目既有裁决(report-dev-2026-11-04-0600 §B-2:
  「改 HTTP 码会破坏前端拦截器 → 不改」,cfc-web/src/utils/request.js:39 对 HTTP 401
  执行 localStorage.clear() + 跳登录)亦与此一致。

二、本次实际补齐的实现缺口(不改变已冻结契约的对外可见行为)
1. login() 入参校验前置:空串/纯空白 phone+code → 400「手机号和验证码不能为空」
   (原仅判 null,空串会穿到验证码校验后被当作业务失败并计入锁定次数);
2. 手机号格式非法 → 400「手机号格式不正确」(与 send-code 同口径),非法输入不进锁定计数;
3. 登录主体抽为 doLogin(),外层 try/catch(RuntimeException):DB/Redis/下游抖动等未预期异常
   不再冒泡成 5xx + 堆栈,服务端日志记完整堆栈(手机号脱敏 maskPhone),响应固定文案
   「登录服务暂时不可用,请稍后重试」(业务码 503),零内部信息外泄;
4. 新增控制器级 @ExceptionHandler(HttpMessageNotReadableException):JSON 语法错误 /
   字段类型不匹配 → 400 信封,不回传解析器原始信息(与 GlobalExceptionHandler 同口径,
   保证 standalone/独立部署下同样不泄露)。

三、验证(offline 实跑)
- mvn -q -DskipTests compile:通过;
- AdminAuthControllerLoginContractTest:15/15 通过;
- 同域 AdminAuthControllerLoginStatusTest 10 + AdminAuthWechatScanTest 11:合计 36/36 通过,无回归;
- 冒烟(临时用例,验后已删):畸形 JSON `{not-json` → HTTP 200 + code 400 无 stack;
  `{"phone":123,"code":true}` → code 400「手机号格式不正确」;空串 phone → code 400;
  非法 phone → code 400;均无 5xx、无异常栈;
- cfc-web `vue-cli-service build`:DONE(本次零前端改动,仅回归验证;未跑 prebuild 以免版本号副作用)。

四、残留(需编排侧裁决,非实现可单方闭环)
把业务拒绝从 500 改为 401/403、锁定改为 429,属「测试契约 + 前端拦截器」联合变更:
需同步改 AdminAuthControllerLoginContractTest 断言,并确认 cfc-web 拦截器对登录端点
401 的处理(当前会清本地态并跳转 /login,吞掉「验证码错误」提示)。
Sisyphus 1 tydzień temu
rodzic
commit
68147c41e0

+ 46 - 1
cfc-backend/src/main/java/com/etotem/cfc/controller/admin/AdminAuthController.java

@@ -16,6 +16,7 @@ import com.etotem.cfc.service.WechatWebLoginService;
 import lombok.extern.slf4j.Slf4j;
 import javax.annotation.Resource;
 import org.springframework.beans.factory.annotation.Value;
+import org.springframework.http.converter.HttpMessageNotReadableException;
 import org.springframework.web.bind.annotation.*;
 
 import javax.servlet.http.HttpServletRequest;
@@ -103,10 +104,31 @@ public class AdminAuthController {
         if (dto == null) {
             return Result.error(400, "请求参数格式错误,请检查请求体 JSON 或字段类型");
         }
-        if (dto.getPhone() == null || dto.getCode() == null) {
+        String phone = dto.getPhone();
+        String code = dto.getCode();
+        // 空串 / 纯空白同样视为「缺参」,不能放行到验证码校验后被当成业务失败计次
+        if (isBlank(phone) || isBlank(code)) {
             return Result.error(400, "手机号和验证码不能为空");
         }
+        // 手机号格式属参数校验 → 400(与 send-code 同口径),非法输入不得进入锁定计数
+        if (!phone.matches("^1[3-9]\\d{9}$")) {
+            return Result.error(400, "手机号格式不正确");
+        }
 
+        // B-2:登录链路的依赖异常(DB/Redis/下游抖动)不得以 HTTP 5xx + 异常栈形式暴露给调用方;
+        // 完整堆栈只进服务端日志(手机号脱敏),响应侧固定文案,避免内部信息外泄。
+        try {
+            return doLogin(dto, request);
+        } catch (RuntimeException e) {
+            log.error("管理员验证码登录处理异常: phone={}", maskPhone(phone), e);
+            return Result.error(503, "登录服务暂时不可用,请稍后重试");
+        }
+    }
+
+    /**
+     * 验证码登录主体:入参已通过参数校验,此处只处理锁定检查、验证码校验、角色判定与 token 签发。
+     */
+    private Result<Map<String, Object>> doLogin(AdminLoginDTO dto, HttpServletRequest request) {
         String ip = getClientIP(request);
         String lockKey = dto.getPhone() + ":" + ip;
         if (loginAttemptService.isBlocked(lockKey)) {
@@ -167,6 +189,16 @@ public class AdminAuthController {
         return Result.success(result);
     }
 
+    /**
+     * B-2:请求体 JSON 语法错误 / 字段类型不匹配(如 phone 传数字)→ 400 信封,
+     * 不回传解析器原始信息与堆栈;与 {@code GlobalExceptionHandler} 同口径,保证独立部署/测试环境一致。
+     */
+    @ExceptionHandler(HttpMessageNotReadableException.class)
+    public Result<Map<String, Object>> handleUnreadableBody(HttpMessageNotReadableException e) {
+        log.warn("管理员登录请求体解析失败: {}", e.getMessage());
+        return Result.error(400, "请求参数格式错误,请检查请求体 JSON 或字段类型");
+    }
+
     /**
      * 获取当前登录管理员信息
      */
@@ -508,6 +540,19 @@ public class AdminAuthController {
         return ip;
     }
 
+    /** 空串/纯空白判定(入参校验前置,避免把空值当业务失败处理) */
+    private static boolean isBlank(String value) {
+        return value == null || value.trim().isEmpty();
+    }
+
+    /** 日志脱敏:手机号仅保留前 3 位与后 4 位,避免日志侧泄露完整号码 */
+    private static String maskPhone(String phone) {
+        if (phone == null || phone.length() < 7) {
+            return "***";
+        }
+        return phone.substring(0, 3) + "****" + phone.substring(phone.length() - 4);
+    }
+
     /**
      * 解析用户的后台角色:
      * 1. 优先从 roles 数组取第一个后台角色(遗留角色归一化为新枚举);