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:修改配置+调整状态码(简单方案)
- 首先调整异常的状态码匹配异常语义,比如改成400业务错误,同时可将reason替换为中文提示:
@ResponseStatus(value= HttpStatus.BAD_REQUEST, reason="队列中没有可用的AuthId,请先推送部分AuthId。") public class NoAuthIdsAvailableException extends RuntimeException {}
- 在项目的
application.properties配置文件中添加以下配置,开启错误信息返回:
# 始终返回错误提示信息 server.error.include-message=always # 不需要白标页的话可以加下面这行关闭,直接返回JSON格式错误 server.error.whitelabel.enabled=false
调整后接口会返回包含你自定义reason的错误响应,不会再出现白标页。
方法2:全局异常捕获(灵活可控,更推荐)
如果需要自定义返回的JSON结构,用@RestControllerAdvice做全局异常处理,自由度更高:
- 先调整异常类定义:
public class NoAuthIdsAvailableException extends RuntimeException { public NoAuthIdsAvailableException() { super("队列中没有可用的AuthId,请先推送部分AuthId。"); } }
- 新增全局异常处理类:
@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
相关产品推荐
相关产品推荐

