多对多关系下仅传嵌套对象ID保存主对象触发TransientObjectException

你遇到的TransientObjectException是因为新建的RoleEntity对象属于瞬时态（Transient），虽然设置了ID，但JPA无法识别它对应数据库中已存在的持久态记录，会尝试保存这个瞬时对象，而你并没有保存新角色的意图，因此触发异常。

解决方案 #

方法1：使用EntityManager.getReference获取代理对象 #

通过EntityManager.getReference获取角色的代理实例，该实例是持久态的，JPA不会尝试保存它，仅在需要时加载数据，性能更优。

修改业务代码：

@Transactional
public UserEntity createUser() {
    UserEntity userEntity = new UserEntity();
    
    List<RoleEntity> roleEntities = new ArrayList<>();
    // 获取已存在角色的代理对象
    RoleEntity roleEntity = entityManager.getReference(RoleEntity.class, "1");
    roleEntities.add(roleEntity);
    userEntity.setRoles(roleEntities);

    return userRepository.save(userEntity);
}

注：需在业务类中注入EntityManager。

方法2：通过Repository查询获取持久态实体 #

如果需要获取角色的完整数据，可直接通过RoleRepository查询已存在的角色实体再关联：

@Transactional
public UserEntity createUser() {
    UserEntity userEntity = new UserEntity();
    
    List<RoleEntity> roleEntities = new ArrayList<>();
    // 查询持久态角色
    RoleEntity roleEntity = roleRepository.findById("1")
            .orElseThrow(() -> new RuntimeException("角色不存在"));
    roleEntities.add(roleEntity);
    userEntity.setRoles(roleEntities);

    return userRepository.save(userEntity);
}

关于Cascade.Merge未生效的说明 #

添加Cascade.MERGE的思路本身可行，但需注意：

• 确保注解配置正确：

  @ManyToMany(cascade = CascadeType.MERGE)
  @JoinTable(
          name = "role_user",
          joinColumns = @JoinColumn(name = "user_id"),
          inverseJoinColumns = @JoinColumn(name = "role_id"))
  private List<RoleEntity> roles;
  

• 数据库中必须确实存在ID为1的RoleEntity，否则merge会尝试保存瞬时对象，依然报错。

不过相比级联操作，前面两种方法更直接，更贴合“仅关联已存在实体”的需求。

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