You need to enable JavaScript to run this app. Spring Whitelabel错误页不显示@ResponseStatus自定义错误信息如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Spring Whitelabel错误页不显示@ResponseStatus自定义错误信息如何解决

问题原因
  • 你自定义异常时将@ResponseStatus的状态值设置为了HttpStatus.OK(200),语义上200代表请求正常处理,Spring检测到请求抛出异常但返回状态为200时,会自动转发到默认的/error路径处理,触发了默认白标错误页。
  • 默认配置下Spring Boot不会把@ResponseStatus的reason属性值直接返回给客户端,所以错误页里看不到你自定义的提示内容。

你遇到的白标页内容翻译如下:

白标错误页
本应用没有配置/error路径的显式映射,因此你看到的是 fallback 错误页
2021年7月19日 周一 美国东部夏令时 16:41:51
发生了非预期错误(类型:OK,状态码:200)

解决方法

方法1:修改配置+调整状态码(简单方案)

  1. 首先调整异常的状态码匹配异常语义,比如改成400业务错误,同时可将reason替换为中文提示:
@ResponseStatus(value= HttpStatus.BAD_REQUEST,
        reason="队列中没有可用的AuthId,请先推送部分AuthId。")
public class NoAuthIdsAvailableException extends RuntimeException {}
  1. 在项目的application.properties配置文件中添加以下配置,开启错误信息返回:
# 始终返回错误提示信息
server.error.include-message=always
# 不需要白标页的话可以加下面这行关闭,直接返回JSON格式错误
server.error.whitelabel.enabled=false

调整后接口会返回包含你自定义reason的错误响应,不会再出现白标页。

方法2:全局异常捕获(灵活可控,更推荐)

如果需要自定义返回的JSON结构,用@RestControllerAdvice做全局异常处理,自由度更高:

  1. 先调整异常类定义:
public class NoAuthIdsAvailableException extends RuntimeException {
    public NoAuthIdsAvailableException() {
        super("队列中没有可用的AuthId,请先推送部分AuthId。");
    }
}
  1. 新增全局异常处理类:
@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(NoAuthIdsAvailableException.class)
    public ResponseEntity<Map<String, Object>> handleNoAuthIdsException(NoAuthIdsAvailableException e) {
        Map<String, Object> res = new HashMap<>();
        res.put("code", 400);
        res.put("message", e.getMessage());
        // 可自定义添加其他字段,比如data、timestamp等
        return new ResponseEntity<>(res, HttpStatus.BAD_REQUEST);
    }
}

这种方式可以完全自定义返回的结构和状态码,不会触发Spring默认的错误处理逻辑,更适合前后端分离的项目统一错误格式。

内容的提问来源于stack exchange,提问作者CaptainB

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.11 20:42:04