暂存提交

2026-07-30 18:01:36 +08:00
commit 2f4e159356
368 changed files with 20370 additions and 0 deletions
@@ -0,0 +1,102 @@
+package com.baiyue.common.web;
+
+import com.baiyue.common.core.api.ApiResponse;
+import com.baiyue.common.core.api.ResultCode;
+import com.baiyue.common.core.exception.BizException;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.validation.ConstraintViolationException;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.AccessDeniedException;
+import org.springframework.security.core.AuthenticationException;
+import org.springframework.validation.BindException;
+import org.springframework.validation.FieldError;
+import org.springframework.http.converter.HttpMessageNotReadableException;
+import org.springframework.web.bind.MethodArgumentNotValidException;
+import org.springframework.web.bind.MissingServletRequestParameterException;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+/**
+ * Servlet Web 全局异常处理器，将业务异常、参数校验异常和系统异常转换为统一 API 响应。
+ */
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+    private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);
+
+    @ExceptionHandler(BizException.class)
+    public ResponseEntity<ApiResponse<Void>> handleBusiness(BizException exception, HttpServletRequest request) {
+        return failure(exception.getResultCode(), exception.getMessage(), request);
+    }
+
+    @ExceptionHandler(MethodArgumentNotValidException.class)
+    public ResponseEntity<ApiResponse<Map<String, String>>> handleValidation(
+            MethodArgumentNotValidException exception, HttpServletRequest request) {
+        return validationResponse(fieldErrors(exception.getBindingResult().getFieldErrors()), request);
+    }
+
+    @ExceptionHandler(BindException.class)
+    public ResponseEntity<ApiResponse<Map<String, String>>> handleBinding(
+            BindException exception, HttpServletRequest request) {
+        return validationResponse(fieldErrors(exception.getBindingResult().getFieldErrors()), request);
+    }
+
+    @ExceptionHandler(ConstraintViolationException.class)
+    public ResponseEntity<ApiResponse<Map<String, String>>> handleConstraint(
+            ConstraintViolationException exception, HttpServletRequest request) {
+        Map<String, String> errors = new LinkedHashMap<>();
+        exception.getConstraintViolations().forEach(violation ->
+                errors.put(violation.getPropertyPath().toString(), violation.getMessage()));
+        return validationResponse(errors, request);
+    }
+
+    @ExceptionHandler({HttpMessageNotReadableException.class, MissingServletRequestParameterException.class})
+    public ResponseEntity<ApiResponse<Void>> handleBadRequest(Exception exception, HttpServletRequest request) {
+        return failure(ResultCode.BAD_REQUEST, ResultCode.BAD_REQUEST.message(), request);
+    }
+
+    @ExceptionHandler(AuthenticationException.class)
+    public ResponseEntity<ApiResponse<Void>> handleAuthentication(
+            AuthenticationException exception, HttpServletRequest request) {
+        return failure(ResultCode.UNAUTHORIZED, ResultCode.UNAUTHORIZED.message(), request);
+    }
+
+    @ExceptionHandler(AccessDeniedException.class)
+    public ResponseEntity<ApiResponse<Void>> handleAccessDenied(
+            AccessDeniedException exception, HttpServletRequest request) {
+        return failure(ResultCode.FORBIDDEN, ResultCode.FORBIDDEN.message(), request);
+    }
+
+    @ExceptionHandler(Exception.class)
+    public ResponseEntity<ApiResponse<Void>> handleUnexpected(Exception exception, HttpServletRequest request) {
+        log.error("Unhandled request failure requestId={} traceId={}",
+                CorrelationContext.requestId(request), CorrelationContext.traceId(request), exception);
+        return failure(ResultCode.INTERNAL_ERROR, ResultCode.INTERNAL_ERROR.message(), request);
+    }
+
+    private Map<String, String> fieldErrors(Iterable<FieldError> fieldErrors) {
+        Map<String, String> errors = new LinkedHashMap<>();
+        fieldErrors.forEach(error -> errors.putIfAbsent(error.getField(), error.getDefaultMessage()));
+        return errors;
+    }
+
+    private ResponseEntity<ApiResponse<Map<String, String>>> validationResponse(
+            Map<String, String> errors, HttpServletRequest request) {
+        ResultCode code = ResultCode.VALIDATION_FAILED;
+        ApiResponse<Map<String, String>> body = ApiResponse.of(code, code.message(), errors,
+                CorrelationContext.requestId(request), CorrelationContext.traceId(request));
+        return ResponseEntity.status(code.httpStatus()).body(body);
+    }
+
+    private ResponseEntity<ApiResponse<Void>> failure(ResultCode code, String message,
+                                                       HttpServletRequest request) {
+        ApiResponse<Void> body = ApiResponse.failure(code, message,
+                CorrelationContext.requestId(request), CorrelationContext.traceId(request));
+        return ResponseEntity.status(code.httpStatus()).body(body);
+    }
+}
+