spring boot 全局异常处理通过 @controlleradvice 配合 @exceptionhandler 捕获网络异常,核心在于拦截 httpmessagenotreadableexception(请求体解析失败)和 bindexception(参数校验失败)。针对 json 反序列化错误,需自定义 httpmessageconverter 或配置 objectmapper 的 deserializationfeature 来统一返回格式;针对参数绑定错误,则直接利用 spring mvc 内置的校验机制进行统一响应。这样能确保所有因网络传输、数据格式或参数缺失导致的异常都被集中处理。

如何统一处理 JSON 反序列化失败的网络异常
当客户端发送格式错误的 JSON 时,Spring Boot 默认会抛出 HttpMessageNotReadableException,导致返回 500 错误且无明确提示。解决方法是注册一个全局异常处理器,专门捕获该异常并提取根因信息,返回标准的 JSON 错误响应。这能避免前端收到晦涩的堆栈跟踪,提升调试效率。

{
"type": "https://example.com/probs/out-of-range",
"title": "HTTP 400 Bad Request",
"status": 400,
"detail": "JSON parse error: Cannot deserialize value of type `java.time.LocalDate` from String \"invalid-date\": text could not be parsed...",
"instance": "/api/users"
}
如何统一处理参数绑定与校验失败的网络异常
当请求参数类型不匹配或缺少必填字段时,Spring MVC 会抛出 MethodArgumentNotValidException 或 BindException。通过在全局异常处理器中捕获这些异常,可以遍历 FieldError 对象,收集所有字段的校验错误信息,并将其组装为列表返回给客户端。这种方式比逐个检查每个参数更简洁,且能一次性反馈所有校验问题。

{
"type": "https://example.com/probs/parameter-binding-failure",
"title": "HTTP 400 Bad Request",
"status": 400,
"detail": "Validation failed for object='userCreationRequest'. Error count: 2",
"errors": [
{
"field": "email",
"message": "must be a valid email address"
},
{
"field": "age",
"message": "must be greater than or equal to 18"
}
],
"instance": "/api/users"
}
基于程序中某个输入、条件或结果的具体问题
在实现上述全局异常处理后,如果客户端发送的请求体中包含一个非预期的字段(例如额外传入了 extra_field),而对应的 DTO 类未使用 @JsonIgnoreProperties(ignoreUnknown = true) 注解,程序会抛出 UnrecognizedPropertyException。这是一个 JsonProcessingException 的子类,它会被 @ExceptionHandler(HttpMessageNotReadableException.class) 捕获吗?答案是:不会直接捕获,因为 UnrecognizedPropertyException 不是 HttpMessageNotReadableException 的直接子类,但它是 JsonProcessingException 的子类,而 HttpMessageNotReadableException 通常包装了 JsonProcessingException。因此,在实际测试中,HttpMessageNotReadableException 确实能捕获到由 UnrecognizedPropertyException 引发的异常,前提是 ObjectMapper 的配置允许抛出此异常(默认情况下,如果未配置 FAIL_ON_UNKNOWN_PROPERTIES 为 false,则会抛出)。为了验证这一点,我们可以编写一个简单的测试用例,发送包含额外字段的 JSON,观察全局异常处理器是否能正确捕获并返回 400 状态码及详细的错误信息。如果配置了 FAIL_ON_UNKNOWN_PROPERTIES 为 false,则该异常不会抛出,而是忽略未知字段,此时全局异常处理器不会触发。因此,关键条件在于 ObjectMapper 的配置以及是否启用了严格模式。


















