Spring Boot JPA单向一对一共享主键：REST接口报错问题排查

1. 修复JSON无限递归（StackOverflowError）错误 #

这个错误的核心原因是Employee和Address实体存在双向关联（比如Employee持有Address引用，Address又持有Employee引用），Jackson序列化JSON时会在两个实体间无限循环引用，最终导致栈溢出。以下是几种实用的修复方案：

方案一：使用@JsonIgnore注解 #

在双向关联的其中一方字段上添加该注解，告诉Jackson序列化时忽略这个关联字段，打断循环链。
比如在Address类的employee字段上添加：

@ManyToOne
@JsonIgnore // 忽略该字段的序列化
private Employee employee;

方案二：使用@JsonManagedReference和@JsonBackReference #

这是Jackson专门处理双向关联的注解组合：

• 在关联的主导方（比如Employee的address字段）添加@JsonManagedReference，表示该字段是主动被序列化的一方
• 在关联的从属方（比如Address的employee字段）添加@JsonBackReference，表示该字段不会被序列化，只会在反序列化时被处理
  示例代码：

// Employee类
@OneToOne(mappedBy = "employee", cascade = CascadeType.ALL)
@JsonManagedReference
private Address address;

// Address类
@ManyToOne
@JsonBackReference
private Employee employee;

方案三：使用@JsonIdentityInfo注解 #

给两个实体类都添加该注解，让Jackson在序列化时用实体的唯一标识（比如id）替代重复的对象引用，避免循环：

@Entity
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class Employee {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // 其他字段和关联关系
}

@Entity
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class Address {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // 其他字段和关联关系
}

2. 是否需要AddressRepository？ #

是否需要取决于你的业务操作需求：

• 如果需要直接对Address进行独立操作（比如单独查询某个地址、修改地址信息、删除地址，不需要通过Employee关联），那么必须创建AddressRepository
• 如果所有Address的操作都必须通过Employee来完成（比如只能通过Employee新增/修改/删除关联的地址，从不单独操作Address），那么可以不需要AddressRepository，直接通过EmployeeRepository的关联关系来处理地址的持久化逻辑

内容的提问来源于stack exchange，提问作者Thiagarajan Ramanathan