在 Spring Boot + JPA 项目中，当 City 与 ReligiousPlace 存在双向 @OneToMany/@ManyToOne 关联时，若未正确配置 JSON 序列化策略，Jackson 会因循环引用陷入无限递归，导致接口响应卡死或抛出 StackOverflowError。
在 spring boot + jpa 项目中，当 city 与 religiousplace 存在双向 `@onetomany`/`@manytoone` 关联时，若未正确配置 json 序列化策略，jackson 会因循环引用陷入无限递归，导致接口响应卡死或抛出 `stackoverflowerror`。
这是典型的“双向关联 + 默认 JSON 序列化”引发的问题：City → religious_places → [ReligiousPlace] → city → religious_places → ... 形成闭环。Jackson 在序列化 City 对象时，会尝试序列化其 religious_places 列表；而每个 ReligiousPlace 又持有对 City 的引用，进而再次触发 City 的序列化——如此往复，直至栈溢出。
✅ 正确解法是单向忽略（@JsonIgnore）：仅保留一方参与 JSON 序列化，打破循环链。推荐在双方关联字段上均添加 @JsonIgnore，确保无论从 City 还是 ReligiousPlace 返回响应，都不会触发嵌套序列化：
@Entity
@Table(name = "religious_places")
public class ReligiousPlace {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String name;
@ManyToOne(fetch = FetchType.LAZY) // 建议使用 LAZY 避免 N+1 查询
@JoinColumn(name = "city_id")
@JsonIgnore // ← 关键：阻止 ReligiousPlace 序列化时回写 city
private City city;
// constructors, getters, setters...
}
@Entity
@Table(name = "city")
public class City {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String name;
@OneToMany(mappedBy = "city", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
@JsonIgnore // ← 关键：阻止 City 序列化时展开 religious_places
private List<ReligiousPlace> religiousPlaces; // 推荐使用驼峰命名
// constructors, getters, setters...
}⚠️ 注意事项：
- 不要仅在一方加
@JsonIgnore：若只忽略City.religiousPlaces，但接口返回的是ReligiousPlace列表，则仍会因ReligiousPlace.city触发递归； - 替代方案（进阶）：可使用
@JsonManagedReference/@JsonBackReference实现单向序列化（需严格配对），或@JsonIdentityInfo启用对象引用机制，但@JsonIgnore最简洁、语义最清晰； - 若需在特定 API 中临时包含关联数据（如
/cities/{id}/places），应通过 DTO（Data Transfer Object）显式组装，而非直接返回实体类； -
fetch = FetchType.LAZY配合@JsonIgnore可兼顾性能与安全性，避免无意识的关联加载。
总结：双向 JPA 关系 ≠ 双向 JSON 输出。始终遵循「序列化时只暴露必要层级」原则，用 @JsonIgnore 主动切断循环路径，是保障 REST 接口健壮性的基础实践。
