Java Spring Boot 处理@RequestBody为空的400异常 隐藏响应包类信息
解决方案
不需要逐接口修改@RequestBody配置,通过全局异常拦截替换冗余的错误响应即可,完全消除响应里暴露的包名、类名、方法签名信息,也不用写重复的手动判空样板代码。
实现步骤
- 先明确异常触发逻辑:当保持
@RequestBody默认的required = true配置、传入空请求体时,Spring会抛出HttpMessageNotReadableException,原始异常信息会自动拼接Controller方法的全限定签名,也就是你看到的带项目内部结构的冗余内容。 - 编写全局异常处理类,精准拦截空请求体对应的异常分支,返回自定义格式的响应:
@RestControllerAdvice public class CustomExceptionHandler { @ExceptionHandler(HttpMessageNotReadableException.class) public ResponseEntity<Map<String, Object>> handleBadRequest(HttpMessageNotReadableException e) { Map<String, Object> errorResp = new HashMap<>(); String requestUri = ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes()).getRequest().getRequestURI(); errorResp.put("timestamp", Instant.now().toString()); errorResp.put("status", 400); errorResp.put("error", "Bad Request"); // 匹配空请求体的特定错误分支 if (e.getMessage() != null && e.getMessage().contains("Required request body is missing")) { // 替换为无内部敏感信息的提示语 errorResp.put("message", "Required request body is missing."); } else { // 其他请求体解析错误(比如JSON格式不合法、字段类型不匹配)的场景,按需自定义提示 errorResp.put("message", "Invalid request content."); } errorResp.put("path", requestUri); return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(errorResp); } }
方案特点
- 侵入性极低:不需要修改任何业务接口的代码,不需要把
@RequestBody改成required = false,也不需要在每个接口方法内部重复写空值判断逻辑 - 全局统一:所有接口的空请求体场景都会返回标准化的提示,不会泄露项目内部的代码结构信息
- 可扩展:可以在同一个异常处理器里顺带处理其他请求体解析类的错误,统一输出无敏感信息的响应内容
配置注意:编写完成后需要确保该异常处理类被Spring组件扫描到,和项目现有组件的扫描路径保持一致即可,不需要额外的特殊配置。
内容的提问来源于stack exchange,提问作者Waqar Ahmed
相关产品推荐
相关产品推荐

