级联保存含复合键实体抛出NullPointerException，如何配置Hibernate？

这个坑我之前也踩过！核心原因是你当前的复合主键映射逻辑让Hibernate没法正确处理级联保存的顺序——PersonAddressId里直接把Address实体作为主键的一部分，Hibernate在尝试保存PersonAddress时，需要先获取主键的哈希值，但此时Address还没被持久化，ID还是null，自然就抛出NPE了。

要实现「Person -> Address -> PersonAddress」的保存顺序，我们需要调整关联映射的方式，让Hibernate能先生成Address的ID，再把它绑定到PersonAddress的复合主键中。以下是具体的配置方案：

1. 重构复合主键类PersonAddressId #

把原来直接关联实体的方式，改成用基础类型存储ID值，同时必须实现Serializable，并正确重写equals和hashCode：

@Embeddable
class PersonAddressId implements Serializable {
    private Long personId;
    private Long addressId;

    // JPA要求必须有无参构造器
    public PersonAddressId() {}

    public PersonAddressId(Long personId, Long addressId) {
        this.personId = personId;
        this.addressId = addressId;
    }

    // 必须重写equals和hashCode，确保主键的唯一性判断正确
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        PersonAddressId that = (PersonAddressId) o;
        return Objects.equals(personId, that.personId) && Objects.equals(addressId, that.addressId);
    }

    @Override
    public int hashCode() {
        return Objects.hash(personId, addressId);
    }

    // getter和setter方法
}

2. 调整PersonAddress实体的关联映射 #

把复合主键和实体关联分开，用@MapsId注解将实体关联和主键字段绑定：

@Entity
class PersonAddress {
    @EmbeddedId
    private PersonAddressId id;

    @ManyToOne
    @MapsId("personId") // 绑定到复合主键的personId字段
    @JoinColumn(name = "person_id", nullable = false)
    private Person person;

    @ManyToOne(cascade = CascadeType.ALL)
    @MapsId("addressId") // 绑定到复合主键的addressId字段
    @JoinColumn(name = "address_id", nullable = false)
    private Address address;

    @Column(name = "address_type")
    private String addressType; // 如果是枚举类型，改成对应的枚举即可

    // 便捷构造器，维护关联关系
    public PersonAddress(Person person, Address address, String addressType) {
        this.person = person;
        this.address = address;
        this.addressType = addressType;
        this.id = new PersonAddressId(person.getId(), address.getId());
    }

    // 无参构造器
    public PersonAddress() {}

    // getter和setter方法
}

3. 修改Person实体的关联配置 #

改用mappedBy让PersonAddress维护关联关系，同时添加便捷方法确保双向关联正确：

@Entity
class Person {
    @Id
    @GeneratedValue
    private Long id;

    @OneToMany(mappedBy = "person", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<PersonAddress> addresses = new ArrayList<>();

    // 便捷方法：添加地址时自动维护双向关联
    public void addAddress(Address address, String addressType) {
        PersonAddress personAddress = new PersonAddress(this, address, addressType);
        addresses.add(personAddress);
        // 如果Address也维护关联集合，这里可以加上address.getPersonAddresses().add(personAddress);
    }

    // getter和setter方法
}

4. 调整Address实体（可选，若需双向关联） #

@Entity
public class Address {
    @Id
    @GeneratedValue
    @Column(name = "address_id")
    private Long id;

    @OneToMany(mappedBy = "address")
    private List<PersonAddress> personAddresses = new ArrayList<>();

    // getter和setter方法
}

为什么这样能解决问题？ #

• 现在复合主键存储的是基础类型的ID值，Hibernate会优先处理CascadeType.ALL标记的Address，生成它的ID后，通过@MapsId自动把ID注入到PersonAddress的复合主键中。
• 当Person被保存时，Hibernate会先生成Person的ID，再处理Address的持久化，最后用两个生成好的ID组装PersonAddress的主键，避免了null值导致的哈希计算异常。

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