JPA实体一对一映射时出现Jackson序列化器未找到错误的原因

错误根源 #

你遇到的序列化错误，核心原因是Hibernate懒加载代理无法被Jackson序列化：

• 你给Vehicle的model字段设置了FetchType.LAZY，Hibernate会为VehicleModel生成代理类（比如VehicleModel$HibernateProxy$zuv5wN1w），这个代理类包含hibernateLazyInitializer等Hibernate内部属性；
• 当Jackson尝试序列化该代理对象时，找不到对应序列化器，也无法识别这些内部属性，因此抛出异常。

解决方案 #

1. 解决懒加载序列化问题（三选一） #

方案一：改用立即加载（简单但影响性能）

如果数据量不大，可直接将懒加载改为立即加载，让Hibernate查询Vehicle时同步加载关联的VehicleModel：

@OneToOne(fetch = FetchType.EAGER)
@JoinColumn(name = "model_id", referencedColumnName = "id")
private VehicleModel model;

方案二：使用Jackson Hibernate模块（推荐）

添加Jackson针对Hibernate的序列化模块，使其能正确处理懒加载代理：

• 添加依赖（Spring Boot项目）：

  <dependency>
      <groupId>com.fasterxml.jackson.datatype</groupId>
      <artifactId>jackson-datatype-hibernate5</artifactId>
  </dependency>
  

• 注册模块：

  @Configuration
  public class JacksonConfig {
      @Bean
      public Module hibernateModule() {
          return new Hibernate5Module();
      }
  }
  

  该模块会自动初始化未加载的懒加载对象，或忽略Hibernate代理的内部属性。

方案三：忽略代理类的内部属性

在VehicleModel类上添加注解，让Jackson忽略Hibernate代理的内部属性：

@Entity
@Table(name = "vehicle_model")
@Data
@JsonIgnoreProperties({"hibernateLazyInitializer", "handler"})
public class VehicleModel {
    // 原有代码...
}

2. 修复双向一对一关联（可选） #

你注释掉VehicleModel里的vehicle字段是因为循环引用导致崩溃，其实可通过Jackson注解解决该问题，同时保留双向关联：

• 在Vehicle的model字段添加@JsonManagedReference（标记主动序列化的一方）：

  @OneToOne(fetch = FetchType.LAZY)
  @JoinColumn(name = "model_id", referencedColumnName = "id")
  @JsonManagedReference
  private VehicleModel model;
  

• 在VehicleModel的vehicle字段添加@JsonBackReference（标记被动序列化的一方，避免循环）：

  @OneToOne(mappedBy = "model")
  @JsonBackReference
  private Vehicle vehicle;
  

完成上述配置后，既能正确序列化出你想要的嵌套VehicleModel格式，也能避免循环引用和服务器崩溃问题。

内容的提问来源于stack exchange，提问作者Rob Gravelle