Postman传递RequestBody时陷入循环问题求助

核心原因 #

双向关联的JPA实体（Customer和Transaction）在JSON序列化/反序列化时会互相引用，形成循环；同时构造请求体时因双向依赖陷入死循环，无法完成请求。

解决方案 #

1. 使用DTO（推荐方案） #

定义专门的请求/响应数据传输对象（DTO），仅保留业务所需字段，规避实体的双向关联传递。

定义TransactionRequestDTO

public class TransactionRequestDTO {
    private Date date;
    private int amount;
    // 仅传递关联Customer的唯一标识，比如主键或唯一字段
    private String customerEmail;

    // getter、setter方法
}

修改Controller方法

@PostMapping("/record-transaction")
public Transaction recordTransaction(@RequestBody TransactionRequestDTO transactionDTO) {
    // 从数据库根据唯一标识查询Customer实体
    Customer customer = customerRepository.findByEmail(transactionDTO.getCustomerEmail());
    // 构造Transaction实体并关联查询到的Customer
    Transaction transaction = new Transaction();
    transaction.setDate(transactionDTO.getDate());
    transaction.setAmount(transactionDTO.getAmount());
    transaction.setCustomer(customer);
    return transactionService.addTransaction(transaction);
}

Postman请求体示例（无需传递整个关联对象）：

{
    "date": "2024-05-20",
    "amount": 100,
    "customerEmail": "test@example.com"
}

2. 使用Jackson注解控制序列化/反序列化 #

若不想新增DTO，可在实体类上添加Jackson注解，忽略循环引用的字段：

方式一：直接忽略关联字段

在Customer类的transaction字段上添加@JsonIgnore：

@Entity
@Table(name = "customers")
public class Customer implements Serializable{
    // ...其他字段
    
    @OneToMany (mappedBy = "customer", fetch = FetchType.LAZY)
    @JsonIgnore // 忽略该字段的序列化/反序列化
    private List<Transaction> transaction;
}

方式二：使用双向引用注解

在Customer的transaction字段添加@JsonManagedReference，在Transaction的customer字段添加@JsonBackReference：

// Customer类
@OneToMany (mappedBy = "customer", fetch = FetchType.LAZY)
@JsonManagedReference // 主动引用，序列化时保留该字段
private List<Transaction> transaction;

// Transaction类
@ManyToOne(fetch = FetchType.LAZY, optional = false)
@JoinColumn(name = "custID", nullable= false)
@JsonBackReference // 被动引用，序列化时忽略该字段，避免循环
private Customer customer;

此时Postman请求体只需传递Customer的唯一标识，无需完整对象：

{
    "date": "2024-05-20",
    "amount": 100,
    "customer": {
        "email": "test@example.com"
    }
}

3. 临时优化请求体构造（不推荐） #

若暂时不想修改代码，构造请求体时仅传递关联对象的唯一标识，省略其他字段和关联列表：

{
    "date": "2024-05-20",
    "amount": 100,
    "customer": {
        "email": "test@example.com"
    }
}

该方式依赖JPA的对象合并机制，代码可读性和可控性较差，仅适合临时场景。

内容的提问来源于stack exchange，提问作者Bibek Bhattarai