Spring Data JPA关联子实体非主键初始化报TransientPropertyValueException

• JPA/Hibernate 在处理@ManyToOne外键关联的插入逻辑时，判断关联对象是否为瞬态新实例的唯一依据是实例的主键值是否为默认未赋值状态：如果关联实例的主键字段已经被手动赋值（比如new Terminal(1L)），Hibernate会直接将该主键值作为外键写入，不会触发瞬态对象的级联保存校验。
• 如果关联实例的主键字段是默认值0，仅给非主键的唯一业务字段赋值（比如new Terminal("core123")），Hibernate会判定这是一个需要被持久化的全新瞬态对象，尝试对其执行级联保存流程，最终因为数据库已存在同code记录、或关联对象未托管抛出TransientPropertyValueException。
• 单独给code字段添加@NaturalId无效的原因：该注解仅提供自然键的映射规则、支持自然键维度的缓存匹配，不会让Hibernate自动将手动new的、带自然键值的非托管实例识别为已存在的关联引用。

所有方案都满足不加载Terminal全量字段、仅通过业务code完成关联绑定的需求，按改动量从低到高排序：

方案1：轻量主键查询+懒加载代理 #

该方案运行效率和原本手动new带id的Terminal的逻辑几乎一致，仅多一次仅查询id字段的轻量SQL，无全量字段加载开销：

1. 在TerminalRepo中新增按code查询主键的方法：

   public interface TerminalRepo extends JpaRepository<Terminal, Long> {
       @Query("SELECT t.id FROM Terminal t WHERE t.code = :code")
       Long findIdByCode(@Param("code") String code);
   }
   

2. 组装待保存的维护实体时，先通过code拿到对应Terminal的主键，再通过JPA原生的getReferenceById方法获取懒加载代理对象，设置为关联属性：

   // 仅查询Terminal的id字段
   Long terminalId = terminalRepo.findIdByCode("core123");
   // 获取仅带主键的懒加载代理，不触发数据库全量查询
   Terminal terminalProxy = terminalRepo.getReferenceById(terminalId);
   // 组装实体并保存
   TerminalMaintenance terminalMaintenance = new TerminalMaintenance();
   terminalMaintenance.setTerminal(terminalProxy);
   terminalMaintenanceRepo.save(terminalMaintenance);
   

方案2：基于@NaturalId的原生代理加载 #

正确配置自然键映射后，可直接通过Hibernate自然键API获取懒加载代理，无需手动编写按code查id的语句：

1. 在Terminal实体的code字段上补充自然键注解：

   @NaturalId
   @Column(name = "code", unique = true)
   private String code;
   

2. 持久化时，注入HibernateSession对象，通过自然键API直接获取实体引用：

   // 获取Terminal的懒加载代理，无全量字段加载
   Terminal terminalProxy = session.bySimpleNaturalId(Terminal.class)
                                   .setOptional("core123")
                                   .getReference();
   // 组装并保存维护实体
   TerminalMaintenance terminalMaintenance = new TerminalMaintenance();
   terminalMaintenance.setTerminal(terminalProxy);
   terminalMaintenanceRepo.save(terminalMaintenance);
   

   该方法生成的代理对象与主键代理的运行逻辑完全一致，持久化上下文会正确识别其身份，不会触发瞬态校验异常。

方案3：自定义原生插入逻辑 #

不需要走JPA实体生命周期校验时，可直接编写自定义插入语句，通过code匹配对应的Terminal主键，直接写入维护表，完全绕过对象关联校验流程，适合批量写入场景：

public interface TerminalMaintenanceRepo extends JpaRepository<TerminalMaintenance, Long> {
    @Modifying
    @Transactional
    @Query(
        value = "INSERT INTO terminal_maintenance (code, terminal_id) " +
                "SELECT :maintenanceCode, t.id FROM terminal t WHERE t.code = :terminalCode",
        nativeQuery = true
    )
    void insertMaintenanceByTerminalCode(String maintenanceCode, String terminalCode);
}

直接调用该方法即可完成记录持久化，全程无需构造Terminal实体对象，性能为所有方案中最优。

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