init local code

2026-09-07 09:09:39 +08:00
commit 99cd26b3d2
259 changed files with 20554 additions and 0 deletions
@@ -0,0 +1,56 @@
+package com.yunhai.cms.controller.api;
+
+import com.yunhai.platform.apistd.ApiResponse;
+import com.yunhai.platform.utils.exception.ErrorCode;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.core.Ordered;
+import org.springframework.core.convert.ConversionFailedException;
+import org.springframework.http.converter.HttpMessageNotReadableException;
+import org.springframework.core.annotation.Order;
+import org.springframework.web.bind.MissingServletRequestParameterException;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
+
+/**
+ * 管理端参数级异常翻译（体检 H-1/H-4 根因修复）。
+ *
+ * <p>平台 GlobalExceptionHandler 只兜 @Valid 校验/BizException/全局 Exception，
+ * 三类 Spring MVC 参数绑定异常（缺参/类型不匹配/请求体不可读）落入兜底分支被
+ * 报成 code=6 "内部服务错误"。本 advice 以更高优先级把它们翻译回 code=2 参数错误，
+ * 前端可提示、日志不再噪音；真正的业务/系统异常不受影响（仍走平台处理器，堆栈完整）。
+ */
+@Slf4j
+@Order(Ordered.HIGHEST_PRECEDENCE)
+@RestControllerAdvice(basePackages = "com.yunhai.cms.controller.api")
+public class ApiParamExceptionHandler {
+
+    @ExceptionHandler(MissingServletRequestParameterException.class)
+    public ApiResponse<Object> missingParam(MissingServletRequestParameterException e) {
+        log.warn("管理端缺必填参数: {}", e.getParameterName());
+        return ApiResponse.fail(ErrorCode.PARAM_ERROR, "缺少必填参数：" + e.getParameterName());
+    }
+
+    @ExceptionHandler(MethodArgumentTypeMismatchException.class)
+    public ApiResponse<Object> typeMismatch(MethodArgumentTypeMismatchException e) {
+        String expected = e.getRequiredType() == null ? "" : "（应为 " + e.getRequiredType().getSimpleName() + "）";
+        log.warn("管理端参数类型不匹配: {}={}", e.getName(), e.getValue());
+        return ApiResponse.fail(ErrorCode.PARAM_ERROR, "参数格式不正确：" + e.getName() + expected);
+    }
+
+    /** JSON 解析失败：编码/语法/时间格式（jackson date-format yyyy-MM-dd HH:mm:ss） */
+    @ExceptionHandler(HttpMessageNotReadableException.class)
+    public ApiResponse<Object> unreadable(HttpMessageNotReadableException e) {
+        Throwable cause = e.getCause() == null ? e : e.getCause();
+        String hint = cause.getMessage() == null ? "" : ": " + firstLine(cause.getMessage());
+        log.warn("管理端请求体不可读 {}", firstLine(hint));
+        return ApiResponse.fail(ErrorCode.PARAM_ERROR,
+                "请求体格式错误（JSON/UTF-8/时间格式，时间需 yyyy-MM-dd HH:mm:ss）");
+    }
+
+    private static String firstLine(String s) {
+        int i = s.indexOf('\n');
+        String line = i < 0 ? s : s.substring(0, i);
+        return line.length() > 120 ? line.substring(0, 120) : line;
+    }
+}