Jackson 库进行 JSON 序列化时遇到了 无限递归(Infinite Recursion) 问题
使用 Jackson 库进行 JSON 序列化时遇到了 无限递归(Infinite Recursion) 问题,这是因为两个实体类 ComPointQuotaEntity 和 ComPointEntity 之间存在双向关联(point 和 pointQuota 相互引用),导致序列化时陷入死循环。以下是解决方案:
解决方案
1. 使用 @JsonIgnore 忽略一个方向的引用
在其中一个实体类的关联字段上添加 @JsonIgnore
注解,直接阻止某一方的序列化:
// ComPointQuotaEntity.java
public class ComPointQuotaEntity {
@ManyToOne
@JoinColumn(name = "point_id")
private ComPointEntity point; // 保留此字段的序列化
// 其他字段...
}
// ComPointEntity.java
public class ComPointEntity {
@OneToMany(mappedBy = "point")
@JsonIgnore // 忽略此字段的序列化
private List<ComPointQuotaEntity> pointQuota;
// 其他字段...
}
2. 使用 @JsonManagedReference
和 @JsonBackReference
通过注解明确父子关系,Jackson 会序列化父级(@JsonManagedReference
),但忽略子级(@JsonBackReference
):
// ComPointQuotaEntity.java
public class ComPointQuotaEntity {
@ManyToOne
@JoinColumn(name = "point_id")
@JsonManagedReference // 标记为父级(序列化)
private ComPointEntity point;
// 其他字段...
}
// ComPointEntity.java
public class ComPointEntity {
@OneToMany(mappedBy = "point")
@JsonBackReference // 标记为子级(不序列化)
private List<ComPointQuotaEntity> pointQuota;
// 其他字段...
}
3. 使用 DTO 替代直接序列化实体
创建 Data Transfer Object (DTO),只暴露需要的字段,避免直接序列化 JPA 实体:
public class ComPointQuotaDTO {
private Long id;
private ComPointDTO point; // 避免双向引用
// 其他字段...
}
public class ComPointDTO {
private Long id;
// 不包含 pointQuota 字段
// 其他字段...
}
4. 配置 Jackson 忽略循环引用
在 application.properties 或 application.yml 中配置 Jackson:
# application.properties
spring.jackson.serialization.fail-on-empty-beans=false
spring.jackson.serialization.fail-on-self-references=false
或在代码中配置 ObjectMapper:
@Configuration
public class JacksonConfig {
@Bean
public ObjectMapper objectMapper() {
return new ObjectMapper()
.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false)
.configure(SerializationFeature.FAIL_ON_SELF_REFERENCES, false);
}
}
5. 自定义序列化器(高级)
为关联字段自定义序列化逻辑,跳过循环引用:
public class ComPointQuotaEntity {
@ManyToOne
@JoinColumn(name = "point_id")
@JsonSerialize(using = ComPointEntitySerializer.class)
private ComPointEntity point;
// 其他字段...
}
public class ComPointEntitySerializer extends JsonSerializer<ComPointEntity> {
@Override
public void serialize(ComPointEntity value, JsonGenerator gen, SerializerProvider provider) throws IOException {
if (value != null) {
gen.writeStartObject();
gen.writeNumberField("id", value.getId());
// 仅序列化需要的字段,跳过 pointQuota
gen.writeEndObject();
}
}
}
总结
- 推荐方案 2(@JsonManagedReference 和 @JsonBackReference):简单且能保持双向关联。
>- 推荐方案 3(DTO):彻底解耦序列化逻辑与数据库实体,适合复杂场景。- 避免直接序列化 JPA 实体,尤其是涉及双向关联时。