Spring Boot接口返回401状态但响应体为空问题求助

以下是针对401响应体空白问题的几种可行解决办法：

1. 排查全局异常处理器的干扰 #

如果项目中存在@RestControllerAdvice标注的全局异常处理类，它可能会捕获你抛出的Exception并覆盖手动返回的响应逻辑，导致响应体空白。

解决方式：
调整全局异常处理器，确保它能正确构造包含错误信息的响应体，或者不对登录接口的异常进行拦截。示例代码：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleGlobalException(Exception e) {
        ErrorResponse errorResponse = new ErrorResponse(e.getMessage());
        return ResponseEntity.status(HttpStatus.UNAUTHORIZED).body(errorResponse);
    }
}

// 定义错误响应体类
class ErrorResponse {
    private String message;

    public ErrorResponse(String message) {
        this.message = message;
    }

    public String getMessage() {
        return message;
    }
}

2. 使用统一响应体替代直接返回字符串 #

直接返回字符串可能因Content-Type不匹配（比如Spring Boot默认返回text/plain，而前端期望application/json）导致解析失败，显示空白。

解决方式：
创建统一的API响应体类，无论成功还是失败都返回该对象：

// 统一响应体模板
public class ApiResponse<T> {
    private int code;
    private String message;
    private T data;

    public ApiResponse(int code, String message, T data) {
        this.code = code;
        this.message = message;
        this.data = data;
    }

    // 快速构建成功响应
    public static <T> ApiResponse<T> success(T data) {
        return new ApiResponse<>(200, "操作成功", data);
    }

    // 快速构建失败响应
    public static ApiResponse<Void> fail(int code, String message) {
        return new ApiResponse<>(code, message, null);
    }

    // getter/setter 省略
}

// 修改登录接口
@PostMapping("/access")
public ResponseEntity<ApiResponse<?>> login(@Valid @RequestBody LoginRequestDto loginRequestDto) {
    try {
        return ResponseEntity.ok(ApiResponse.success(authService.login(loginRequestDto)));
    } catch (Exception exception) {
        return ResponseEntity.status(401).body(ApiResponse.fail(401, exception.getMessage()));
    }
}

3. 利用Spring Boot默认异常处理机制 #

你配置的error.include-message: always仅对Spring Boot默认的错误响应生效，手动捕获异常返回时该配置不会触发。可以去掉手动try-catch，让框架自动处理异常：

解决方式：

• 移除接口中的try-catch块，让异常自然抛出
• 自定义异常并添加@ResponseStatus注解指定状态码：

// 自定义未授权异常
@ResponseStatus(HttpStatus.UNAUTHORIZED)
public class UnauthorizedException extends RuntimeException {
    public UnauthorizedException(String message) {
        super(message);
    }
}

// 在AuthService中抛出该异常
public Object login(LoginRequestDto loginRequestDto) {
    // 验证逻辑失败时
    throw new UnauthorizedException("用户名或密码错误");
}

// 修改后的登录接口
@PostMapping("/access")
public ResponseEntity<?> login(@Valid @RequestBody LoginRequestDto loginRequestDto) {
    return ResponseEntity.ok(authService.login(loginRequestDto));
}

4. 检查前端响应处理逻辑 #

部分前端框架（如Axios）在处理4xx/5xx响应时，会进入catch分支，但如果未正确读取error.response.data而是直接使用error.message，会导致无法获取响应体内容。请确认前端代码是否正确解析了401响应的body部分。

内容的提问来源于stack exchange，提问作者Anton Kiselevych