Hibernate同表@ManyToOne关联@EmbeddedId实现多级分类报错求助

你的方案出现循环依赖异常，是因为用@EmbeddedId将父分类实体作为复合主键的一部分，导致Hibernate处理外键时形成了Category依赖CategoryId、CategoryId又依赖Category的循环引用。下面是可行的实现方案：

正确实现代码 #

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

@Entity
@Table(
    name = "category",
    uniqueConstraints = @UniqueConstraint(
        columnNames = {"name", "parent_id"},
        name = "uk_category_parent_name"
    )
)
@Data
@NoArgsConstructor
public class Category {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false)
    private String name;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "parent_id")
    private Category parent;

    @OneToMany(mappedBy = "parent", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<Category> children = new ArrayList<>();

    // 辅助方法：快速添加子分类
    public void addChild(Category child) {
        children.add(child);
        child.setParent(this);
    }
}

方案核心说明 #

• 独立主键：用自增ID作为实体主键，避免复合主键带来的循环依赖问题，同时简化实体操作。
• 联合唯一约束：通过@Table的uniqueConstraints设置name和parent_id的联合唯一索引，确保同一父分类下分类名称唯一；顶级分类的parent_id为null，此时name全局唯一，符合业务逻辑。
• 双向关联：@ManyToOne关联父分类，@OneToMany维护子分类集合，搭配辅助方法addChild可以快速构建分类层级。
• 性能优化：父分类关联使用懒加载（FetchType.LAZY），避免查询分类时不必要的关联数据加载。

示例使用 #

// 创建顶级分类Food
Category food = new Category();
food.setName("Food");

// 创建子分类Vegetable和Meat
Category vegetable = new Category();
vegetable.setName("Vegetable");
food.addChild(vegetable);

Category meat = new Category();
meat.setName("Meat");
food.addChild(meat);

// 持久化顶级分类（子分类会通过级联操作自动保存）
entityManager.persist(food);

原方案失败原因 #

你尝试的@EmbeddedId方案中，CategoryId包含了@ManyToOne关联的Category实例，而Category又以CategoryId作为主键，这形成了循环依赖链：Hibernate无法确定先初始化Category还是CategoryId，最终抛出循环依赖异常。

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