Merge pull request #32 from ReLive27/main

feat: add global exception handler and unified response body wrapper

Author: ReLive27

core/src/main/java/io/github/simpleauth0/core/i18n/SimpleAuth0MessageSource.java

@@ -11,6 +11,7 @@ public class SimpleAuth0MessageSource extends ResourceBundleMessageSource {
 
     private SimpleAuth0MessageSource() {
         setBasename("io.github.simpleauth0.messages");
+        setFallbackToSystemLocale(false);
         setDefaultEncoding("UTF-8");
     }
 

core/src/main/resources/io/github/simpleauth0/messages.properties

@@ -11,3 +11,6 @@ auth.request.parse.failed=登录请求解析失败，请检查请求参数格式
 auth.credentials.missing=未提供认证凭证，禁止访问
 auth.provider.not-found=登录类型错误
 auth.service.internal-error=认证服务内部异常，请稍后重试
+
+user.username.notblank=用户名不能为空
+server.error=系统错误，请联系管理员

core/src/main/resources/io/github/simpleauth0/messages_en.properties

@@ -11,3 +11,7 @@ auth.request.parse.failed=Failed to parse login request. Please check the reques
 auth.credentials.missing=No authentication credentials provided
 auth.provider.not-found=Incorrect login type
 auth.service.internal-error=Internal authentication service error. Please try again later
+
+
+user.username.notblank=Username cannot be blank
+server.error=System error, please contact the administrator.

server/src/main/java/io/github/simpleauth0/web/ApiError.java

@@ -0,0 +1,32 @@
+package io.github.simpleauth0.web;
+
+import lombok.Data;
+
+/**
+ * @author: ReLive27
+ * @date: 2025/11/19 23:22
+ */
+@Data
+public class ApiError {
+    private Integer code;
+    private String errorCode;
+    private String message;
+    private long timestamp = System.currentTimeMillis();
+
+
+    public static ApiError fail(Integer code, String errorCode, String message) {
+        ApiError error = new ApiError();
+        error.code = code;
+        error.errorCode = errorCode;
+        error.message = message;
+        return error;
+    }
+
+    public static ApiError fail(Integer code, String message) {
+        ApiError error = new ApiError();
+        error.code = code;
+        error.errorCode = "";
+        error.message = message;
+        return error;
+    }
+}

server/src/main/java/io/github/simpleauth0/web/ApiResponse.java

@@ -0,0 +1,33 @@
+package io.github.simpleauth0.web;
+
+import lombok.Data;
+import org.springframework.http.HttpStatus;
+
+/**
+ * @author: ReLive27
+ * @date: 2025/11/22 10:59
+ */
+@Data
+public class ApiResponse<T> {
+
+    private Integer code;
+    private String message;
+    private T data;
+    private long timestamp = System.currentTimeMillis();
+
+    public static <T> ApiResponse<T> success(T data) {
+        ApiResponse<T> apiResponse = new ApiResponse<>();
+        apiResponse.code = HttpStatus.OK.value();
+        apiResponse.message = "success";
+        apiResponse.data = data;
+        return apiResponse;
+    }
+
+    public static <T> ApiResponse<T> success(String code, String message) {
+        ApiResponse<T> apiResponse = new ApiResponse<>();
+        apiResponse.code = HttpStatus.OK.value();
+        apiResponse.message = message;
+        apiResponse.data = null;
+        return apiResponse;
+    }
+}

server/src/main/java/io/github/simpleauth0/web/ErrorCodes.java

@@ -0,0 +1,10 @@
+package io.github.simpleauth0.web;
+
+/**
+ * @author: ReLive27
+ * @date: 2025/11/22 11:06
+ */
+public class ErrorCodes {
+    public static final String INVALID_PARAMETER = "INVALID_PARAMETER";
+    public static final String SERVER_ERROR = "SERVER_ERROR";
+}

server/src/main/java/io/github/simpleauth0/web/GlobalExceptionHandler.java

@@ -0,0 +1,37 @@
+package io.github.simpleauth0.web;
+
+import io.github.simpleauth0.core.i18n.SimpleAuth0MessageSource;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.context.i18n.LocaleContextHolder;
+import org.springframework.context.support.MessageSourceAccessor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.MethodArgumentNotValidException;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+/**
+ * @author: ReLive27
+ * @date: 2025/11/19 23:02
+ */
+@Slf4j
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+    private MessageSourceAccessor messageSource = SimpleAuth0MessageSource.getAccessor();
+
+    @ExceptionHandler(MethodArgumentNotValidException.class)
+    public ResponseEntity<Object> handlerMethodException(MethodArgumentNotValidException e) {
+        log.error("参数校验异常", e);
+        String msg = e.getBindingResult().getFieldError().getDefaultMessage();
+        return ResponseEntity.status(HttpStatus.OK)
+                .body(ApiError.fail(HttpStatus.BAD_REQUEST.value(), ErrorCodes.INVALID_PARAMETER, msg));
+    }
+
+    @ExceptionHandler(Exception.class)
+    public ResponseEntity<Object> handlerConfusionException(Exception e) {
+        log.error("系统异常", e);
+        return ResponseEntity.status(HttpStatus.OK)
+                .body(ApiError.fail(HttpStatus.INTERNAL_SERVER_ERROR.value(), ErrorCodes.SERVER_ERROR, messageSource.getMessage("server.error", "系统错误，请联系管理员", LocaleContextHolder.getLocale())));
+    }
+
+}

server/src/main/java/io/github/simpleauth0/web/GlobalResponseBodyAdvice.java

@@ -0,0 +1,41 @@
+package io.github.simpleauth0.web;
+
+import org.springframework.core.MethodParameter;
+import org.springframework.http.MediaType;
+import org.springframework.http.converter.HttpMessageConverter;
+import org.springframework.http.server.ServerHttpRequest;
+import org.springframework.http.server.ServerHttpResponse;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+import org.springframework.web.servlet.mvc.method.annotation.ResponseBodyAdvice;
+
+/**
+ * @author: ReLive27
+ * @date: 2025/11/20 23:03
+ */
+@RestControllerAdvice
+public class GlobalResponseBodyAdvice implements ResponseBodyAdvice<Object> {
+    @Override
+    public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
+        return true;
+    }
+
+    @Override
+    public Object beforeBodyWrite(Object body,
+                                  MethodParameter returnType,
+                                  MediaType selectedContentType,
+                                  Class<? extends HttpMessageConverter<?>> selectedConverterType,
+                                  ServerHttpRequest request,
+                                  ServerHttpResponse response) {
+
+        // 异常情况交给 GlobalExceptionHandler，不在此统一封装
+        if (body instanceof ApiError) {
+            return body;
+        }
+
+        if (body == null) {
+            return ApiResponse.success(null);
+        }
+
+        return ApiResponse.success(body);
+    }
+}