spring boot 全局异常处理捕获序列化异常,核心在于配置 @controlleradvice 并注册 mappingjackson2httpmessageconverter。当 jackson 在将对象序列化为 json 时抛出 jsonprocessingexception,该异常会被 spring mvc 的消息转换器机制捕获,进而触发全局异常处理器中的对应逻辑。

@RestControllerAdvice 如何拦截 JsonProcessingException
通过定义一个继承自 ExceptionHandlerExceptionResolver 或直接在类上标注 @RestControllerAdvice 的组件,可以统一处理所有控制器抛出的异常。针对序列化异常,只需编写一个使用 @ExceptionHandler(JsonProcessingException.class) 注解的方法即可。该方法接收异常对象作为参数,并返回自定义的错误响应体(如 ResponseEntity),从而避免默认的 500 错误页面或堆栈信息泄露给客户端。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import com.fasterxml.jackson.core.JsonProcessingException;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(JsonProcessingException.class)
public ResponseEntity<string> handleSerializationError(JsonProcessingException ex) {
// 记录日志
System.err.println("Serialization failed: " + ex.getMessage());
return ResponseEntity.status(500).body("JSON Serialization Error: " + ex.getOriginalMessage());
}
}</string>
上述代码中,GlobalExceptionHandler 类被 Spring 扫描并注册为全局异常处理器。当任何 Controller 方法在执行过程中,由于字段类型不匹配、循环引用或不可序列化对象导致 Jackson 抛出 JsonProcessingException 时,Spring 会优先匹配到 handleSerializationError 方法。返回值是一个包含错误信息的 HTTP 500 响应。开发者可以通过修改 ex.getOriginalMessage() 获取更详细的底层原因,例如具体的字段名或格式错误。
如何区分 JsonProcessingException 的子类异常
JsonProcessingException 是 Jackson 序列化异常的基类,其子类包括 MismatchedInputException、InvalidDefinitionException 和 DuplicatePropertyException 等。在实际开发中,不同的子类对应不同的业务场景。例如,InvalidDefinitionException 通常发生在缺少无参构造函数或存在不可见字段时,而 MismatchedInputException 则多与输入数据格式不符有关。为了提供更精确的错误提示,可以在全局异常处理器中分别捕获这些子类,或者根据异常消息进行模式匹配。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.exc.InvalidDefinitionException;
import com.fasterxml.jackson.databind.exc.MismatchedInputException;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(InvalidDefinitionException.class)
public ResponseEntity<string> handleInvalidDef(InvalidDefinitionException ex) {
return ResponseEntity.status(400).body("Invalid Definition: " + ex.getMessage());
}
@ExceptionHandler(MismatchedInputException.class)
public ResponseEntity<string> handleMismatch(MismatchedInputException ex) {
return ResponseEntity.status(400).body("Data Mismatch: " + ex.getMessage());
}
@ExceptionHandler(JsonProcessingException.class)
public ResponseEntity<string> handleGeneral(JsonProcessingException ex) {
return ResponseEntity.status(500).body("General Serialization Error: " + ex.getMessage());
}
}</string></string></string>
在上面的代码中,我们定义了三个异常处理方法。由于 Spring 的异常匹配机制是从具体到抽象,因此 InvalidDefinitionException 和 MismatchedInputException 的处理方法会优先于通用的 JsonProcessingException 方法执行。如果请求中的数据缺少必要字段或缺少默认构造函数,客户端将收到 400 状态码及具体的定义错误信息;如果是其他类型的序列化问题,则回退到通用的 500 错误处理。这种分层处理方式有助于前端快速定位问题根源。
当实体类包含循环引用时会发生什么
如果实体类之间存在双向关联(例如 User 类包含 Order 列表,而 Order 类又包含 User 引用),Jackson 在序列化时会陷入无限递归,最终抛出 JsonMappingException(JsonProcessingException 的子类)。此时,全局异常处理器会捕获该异常,但默认的异常信息可能不够直观。开发者可以通过配置 ObjectMapper 来禁用循环引用检查,或者使用 @JsonIgnore 注解忽略特定字段,从而避免异常的发生。若未做特殊处理,异常将被全局处理器捕获并返回标准错误响应。











