如何通过非主键唯一列（自然ID）获取Hibernate实体引用？

你的核心问题是：基于主键获取的User代理仅持有ID属性，而Record外键依赖的是User的自然ID（username），Hibernate无法从该代理中获取username值，导致插入时触发非空约束。以下是几种无需加载完整User实体的解决方案：

1. 通过自然ID获取实体代理 #

既然User的username已标注@NaturalId，可以直接使用Hibernate的API获取基于自然ID的代理，该代理会持有username值，无需额外查询。

实现步骤： #

在UserRepository中添加自定义方法：

public interface UserRepository extends JpaRepository<User, Long> {
    default User getReferenceByUsername(String username) {
        return getEntityManager()
                .unwrap(org.hibernate.Session.class)
                .byNaturalId(User.class)
                .using("username", username)
                .getReference();
    }
}

创建Record时，若直接持有username参数，可直接使用该代理：

@Transactional
public Record createRecord(String username) {
    Record record = new Record();
    // 获取仅持有username的User代理，无额外查询
    record.setUser(userRepository.getReferenceByUsername(username));
    return recordRepository.save(record);
}

2. 结合主键与投影查询优化（适配userId入参场景） #

若你的入参只能是userId，可通过轻量的投影查询获取username，再用自然ID代理，比findById加载完整实体更高效：

实现步骤： #

在UserRepository中添加投影查询方法：

public interface UserRepository extends JpaRepository<User, Long> {
    @Query("SELECT u.username FROM User u WHERE u.id = :id")
    String findUsernameById(@Param("id") Long id);

    default User getReferenceByUsername(String username) {
        return getEntityManager()
                .unwrap(org.hibernate.Session.class)
                .byNaturalId(User.class)
                .using("username", username)
                .getReference();
    }
}

修改createRecord方法：

@Transactional
public Record createRecord(Long userId) {
    // 仅查询username，避免加载完整User实体
    String username = userRepository.findUsernameById(userId);
    if (username == null) {
        throw new RuntimeException("User not found");
    }
    // 通过自然ID获取代理
    User userProxy = userRepository.getReferenceByUsername(username);
    
    Record record = new Record();
    record.setUser(userProxy);
    return recordRepository.save(record);
}

为什么getReferenceById无法解决问题？ #

getReferenceById返回的是基于主键的代理对象，仅初始化了id属性，其他属性（包括username）处于未加载状态。由于Record的外键关联依赖username而非主键，Hibernate无法从该代理中自动获取username值，也不会主动触发加载，最终导致插入时username字段为null，触发非空约束。

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