Hibernate/JPA用UUID生成器持久化OneToMany对象遇非空属性异常

我之前也碰到过一模一样的问题，结合你的场景来看，问题根源在于Hibernate生成UUID的时机以及关联实体的持久化状态检查。下面给你详细分析和可行的解决方案：

问题原因 #

你选择由Hibernate生成UUID，但默认的@GeneratedValue注解在Hibernate 5.2.x版本中，对UUID类型ID的默认生成策略会延迟ID的生成（直到Session flush阶段）。这就导致当Hibernate尝试级联保存TimePeriodBlock时，父实体TimePeriod还没有被分配UUID（处于transient临时状态），而你的TimePeriodBlock.timePeriod字段设置了nullable=false，Hibernate会判定这个关联引用了未持久化的临时对象，从而抛出PropertyValueException。

虽然你在addTimePeriodBlock方法里已经正确设置了双向关联，但Hibernate在检查持久化状态时，会以父实体是否有已生成的ID（即是否处于managed托管状态）作为判断依据，延迟生成UUID的行为刚好触发了这个非空约束检查。

解决方案 #

1. 显式指定UUID生成器，提前生成ID #

修改父类AbstractDomainObject的ID映射，使用Hibernate官方推荐的uuid2生成器，它会在实体被persist时立即生成UUID，确保父实体在级联保存子实体前就处于托管状态：

@MappedSuperclass
public abstract class AbstractDomainObject {
    ...
    @Id
    @GeneratedValue(generator = "uuid2")
    @GenericGenerator(name = "uuid2", strategy = "uuid2")
    @Column(name = "id", columnDefinition = "uuid", updatable = false)
    private UUID id;
    ...
}

uuid2生成器会生成符合RFC 4122标准的UUID字符串，完美适配PostgreSQL的uuid列类型，同时能保证ID在persist阶段就生成，解决关联时的状态问题。

2. 确认双向关联的正确性（你已做对，但再核对） #

你的addTimePeriodBlock方法写法是双向关联的标准正确姿势，确保了关联的一致性：

public void addTimePeriodBlock(TimePeriodBlock timePeriodBlock) {
    timePeriodBlock.setTimePeriod(this);
    this.timePeriodBlocks.add(timePeriodBlock);
}

这个方法同时维护了子实体到父实体的引用，以及父实体的子实体集合，避免了关联不一致的潜在问题。

3. 可选：检查Hibernate全局配置 #

如果修改后仍有问题，可以检查项目的persistence.xml或Hibernate配置文件，确保没有启用旧的生成器映射：

# 确保这个配置是true（Hibernate 5.x默认是true）
hibernate.id.new_generator_mappings=true

如果设置为false，会启用旧版生成器逻辑，可能干扰uuid2的正常工作。

测试验证 #

修改完成后，再执行你的测试代码：

TimePeriod t = new TimePeriod();
t.setName("test");
TimePeriodBlock b = new TimePeriodBlock();
t.addTimePeriodBlock(b);
em.persist(t);

此时Hibernate会在persist(t)时立即生成TimePeriod的UUID，级联保存TimePeriodBlock时，子实体的timePeriod_id会正确关联父实体的UUID，不会再抛出异常。

你提到无关联关系的对象可以正常持久化，这也侧面验证了问题确实出在关联实体的持久化时机上——单个实体persist时，Hibernate可以在flush前生成ID，但级联时因为要立即验证非空约束，必须提前生成父实体的ID。

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