Spring Boot中JSON反序列化自关联实体入库问题

核心问题分析 #

你的问题根源在于两点：

1. 复合主键未正确声明：UserRelation使用了两个@Id字段作为复合主键，但没有通过@IdClass或@EmbeddedId告知JPA主键的组合规则，导致JPA无法正确识别主键结构，进而在保存时错误地尝试查找已存在的实体。
2. 关联关系维护不规范：双向关联中mappedBy的指向、级联操作的配置，以及反序列化后关联对象的赋值逻辑存在疏漏。

具体解决方案 #

1. 定义复合主键类 #

创建一个实现Serializable的复合主键类，对应UserRelation的两个主键字段：

import java.io.Serializable;
import lombok.Data;

@Data
public class UserRelationId implements Serializable {
    private Long userParent; // 与UserRelation中userParent属性名对应
    private Long userIdChild; // 与UserRelation中userIdChild属性名对应
}

2. 修改UserRelation实体 #

修正主键配置、关联关系，同时规范属性命名：

import com.fasterxml.jackson.annotation.JsonIgnore;
import jakarta.persistence.*;
import lombok.Data;

@Entity
@Data
@IdClass(UserRelationId.class) // 指定复合主键类
public class UserRelation {
    @Id
    @ManyToOne
    @JoinColumn(name = "user_id_parent", referencedColumnName = "id", nullable = false)
    @JsonIgnore // 避免双向序列化循环
    private User userParent;

    @Id
    @JsonProperty("user_id")
    @Column(name = "user_id_child")
    private Long userIdChild;

    private String relation;
}

3. 修改User实体 #

调整OneToMany的mappedBy指向和级联配置，确保级联操作覆盖新增/更新：

import jakarta.persistence.*;
import lombok.Data;
import java.util.List;

@Entity
@Data
public class User {
    @Id
    private Long id;
    private String name;

    @OneToMany(mappedBy = "userParent", cascade = {CascadeType.PERSIST, CascadeType.MERGE}, orphanRemoval = true)
    private List<UserRelation> relations;
}

4. 调整保存逻辑 #

反序列化后，确保每个UserRelation都关联到当前User：

ObjectMapper mapper = new ObjectMapper();
User user = mapper.readValue(json.toString(), User.class);

// 手动维护关联关系
if (user.getRelations() != null) {
    user.getRelations().forEach(relation -> relation.setUserParent(user));
}

userRepository.save(user);

错误原因解释 #

• 第一次错误：UserRelation的user_id_parent被定义为Long类型而非User实体，双向关联的映射关系完全错误，JPA无法识别关联关系，且复合主键未声明，导致保存时主键缺失。
• 第二次错误：虽然修正了关联关系，但仍未声明复合主键类，JPA无法解析UserRelation的复合主键结构，因此在执行保存操作时，错误地认为需要查找已存在的UserRelation实体，而非执行新增操作。

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