refactor: 💥 分离 HTTP 状态码和业务状态码

1.传输正常的情况下无论业务是否有异常，HTTP 状态码始终为 200 2.防止非 HTTPS 情况下出现运营商劫持（例如：404）
2025-10-09 04:57:11 +08:00 · 2023-09-10 22:35:50 +08:00
parent a3082e72a9
commit b3b6446433
6 changed files with 44 additions and 63 deletions
--- a/continew-admin-common/src/main/java/top/charles7c/cnadmin/common/handler/GlobalErrorHandler.java
+++ b/continew-admin-common/src/main/java/top/charles7c/cnadmin/common/handler/GlobalErrorHandler.java
@@ -70,7 +70,7 @@ public class GlobalErrorHandler extends BasicErrorController {
        R<Object> result = R.fail(status.value(), (String)errorAttributeMap.get("error"));
        result.setData(path);
        try {
-            response.setStatus(status.value());
+            response.setStatus(HttpStatus.OK.value());
            response.setContentType(MediaType.APPLICATION_JSON_VALUE);
            objectMapper.writeValue(response.getWriter(), result);
        } catch (IOException e) {
@@ -89,6 +89,6 @@ public class GlobalErrorHandler extends BasicErrorController {
        R<Object> result = R.fail(status.value(), (String)errorAttributeMap.get("error"));
        result.setData(path);
        log.error("请求地址 [{}]，发生错误，错误信息：{}。", path, JSONUtil.toJsonStr(errorAttributeMap));
-        return new ResponseEntity<>(BeanUtil.beanToMap(result), status);
+        return new ResponseEntity<>(BeanUtil.beanToMap(result), HttpStatus.OK);
    }
 }
--- a/continew-admin-common/src/main/java/top/charles7c/cnadmin/common/handler/GlobalExceptionHandler.java
+++ b/continew-admin-common/src/main/java/top/charles7c/cnadmin/common/handler/GlobalExceptionHandler.java
@@ -30,7 +30,6 @@ import org.springframework.validation.BindException;
 import org.springframework.web.HttpRequestMethodNotSupportedException;
 import org.springframework.web.bind.MethodArgumentNotValidException;
 import org.springframework.web.bind.annotation.ExceptionHandler;
-import org.springframework.web.bind.annotation.ResponseStatus;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
 import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
 import org.springframework.web.multipart.MaxUploadSizeExceededException;
@@ -62,7 +61,6 @@ public class GlobalExceptionHandler {
    /**
     * 拦截自定义验证异常-错误请求
     */
-    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler(BadRequestException.class)
    public R handleBadRequestException(BadRequestException e, HttpServletRequest request) {
        log.warn("请求地址 [{}]，自定义验证失败。", request.getRequestURI(), e);
@@ -73,7 +71,6 @@ public class GlobalExceptionHandler {
    /**
     * 拦截校验异常-违反约束异常
     */
-    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler(ConstraintViolationException.class)
    public R constraintViolationException(ConstraintViolationException e, HttpServletRequest request) {
        log.warn("请求地址 [{}]，参数验证失败。", request.getRequestURI(), e);
@@ -85,7 +82,6 @@ public class GlobalExceptionHandler {
    /**
     * 拦截校验异常-绑定异常
     */
-    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler(BindException.class)
    public R handleBindException(BindException e, HttpServletRequest request) {
        log.warn("请求地址 [{}]，参数验证失败。", request.getRequestURI(), e);
@@ -97,7 +93,6 @@ public class GlobalExceptionHandler {
    /**
     * 拦截校验异常-方法参数无效异常
     */
-    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public R handleMethodArgumentNotValidException(MethodArgumentNotValidException e, HttpServletRequest request) {
        log.warn("请求地址 [{}]，参数验证失败。", request.getRequestURI(), e);
@@ -110,7 +105,6 @@ public class GlobalExceptionHandler {
    /**
     * 拦截校验异常-方法参数类型不匹配异常
     */
-    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler(MethodArgumentTypeMismatchException.class)
    public R handleMethodArgumentTypeMismatchException(MethodArgumentTypeMismatchException e,
        HttpServletRequest request) {
@@ -123,7 +117,6 @@ public class GlobalExceptionHandler {
    /**
     * 拦截文件上传异常-超过上传大小限制
     */
-    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler(MaxUploadSizeExceededException.class)
    public R handleMaxUploadSizeExceededException(MaxUploadSizeExceededException e, HttpServletRequest request) {
        log.warn("请求地址 [{}]，上传文件失败，文件大小超过限制。", request.getRequestURI(), e);
@@ -136,7 +129,6 @@ public class GlobalExceptionHandler {
    /**
     * 认证异常-登录认证
     */
-    @ResponseStatus(HttpStatus.UNAUTHORIZED)
    @ExceptionHandler(NotLoginException.class)
    public R handleNotLoginException(NotLoginException e, HttpServletRequest request) {
        log.error("请求地址 [{}]，认证失败，无法访问系统资源。", request.getRequestURI(), e);
@@ -159,7 +151,6 @@ public class GlobalExceptionHandler {
    /**
     * 认证异常-权限认证
     */
-    @ResponseStatus(HttpStatus.FORBIDDEN)
    @ExceptionHandler(NotPermissionException.class)
    public R handleNotPermissionException(NotPermissionException e, HttpServletRequest request) {
        log.error("请求地址 [{}]，权限码校验失败。", request.getRequestURI(), e);
@@ -169,7 +160,6 @@ public class GlobalExceptionHandler {
    /**
     * 认证异常-角色认证
     */
-    @ResponseStatus(HttpStatus.FORBIDDEN)
    @ExceptionHandler(NotRoleException.class)
    public R handleNotRoleException(NotRoleException e, HttpServletRequest request) {
        log.error("请求地址 [{}]，角色权限校验失败。", request.getRequestURI(), e);
@@ -179,7 +169,6 @@ public class GlobalExceptionHandler {
    /**
     * 拦截校验异常-请求方式不支持异常
     */
-    @ResponseStatus(HttpStatus.METHOD_NOT_ALLOWED)
    @ExceptionHandler(HttpRequestMethodNotSupportedException.class)
    public R handleHttpRequestMethodNotSupported(HttpRequestMethodNotSupportedException e, HttpServletRequest request) {
        LogContextHolder.setErrorMsg(e.getMessage());
@@ -190,7 +179,6 @@ public class GlobalExceptionHandler {
    /**
     * 拦截业务异常
     */
-    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    @ExceptionHandler(ServiceException.class)
    public R handleServiceException(ServiceException e, HttpServletRequest request) {
        log.error("请求地址 [{}]，发生业务异常。", request.getRequestURI(), e);
@@ -201,7 +189,6 @@ public class GlobalExceptionHandler {
    /**
     * 拦截未知的运行时异常
     */
-    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    @ExceptionHandler(RuntimeException.class)
    public R handleRuntimeException(RuntimeException e, HttpServletRequest request) {
        log.error("请求地址 [{}]，发生系统异常。", request.getRequestURI(), e);
@@ -212,7 +199,6 @@ public class GlobalExceptionHandler {
    /**
     * 拦截未知的系统异常
     */
-    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    @ExceptionHandler(Throwable.class)
    public R handleException(Throwable e, HttpServletRequest request) {
        log.error("请求地址 [{}]，发生未知异常。", request.getRequestURI(), e);
--- a/continew-admin-common/src/main/java/top/charles7c/cnadmin/common/model/vo/R.java
+++ b/continew-admin-common/src/main/java/top/charles7c/cnadmin/common/model/vo/R.java
@@ -45,12 +45,12 @@ public class R<V> implements Serializable {
    @Schema(description = "是否成功", example = "true")
    private boolean success;

-    /** 状态码 */
-    @Schema(description = "状态码", example = "200")
+    /** 业务状态码 */
+    @Schema(description = "业务状态码", example = "200")
    private int code;

-    /** 状态信息 */
-    @Schema(description = "状态信息", example = "操作成功")
+    /** 业务状态信息 */
+    @Schema(description = "业务状态信息", example = "操作成功")
    private String msg;

    /** 返回数据 */