Hibernate配置@JoinColumn关联非主键外键字段的问题解决

方案1：利用自然ID（Natural ID）获取托管实例 #

给Status实体的statusCode字段添加@NaturalId注解，让Hibernate能够通过这个非主键字段识别已存在的实体：

@Entity
public class Status {
    @Id
    @Column(unique = true, nullable = false)
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Short id;

    @NaturalId // 新增注解
    @Column(name = "status_code", unique = true, nullable = false)
    private Short statusCode;
}

然后通过Hibernate的Session（或Spring Data JPA整合方式）获取对应statusCode的托管实例，无需触发实际数据库查询（Hibernate会创建代理对象，仅在访问非ID字段时才执行查询）：

// 注入EntityManager
@Autowired
private EntityManager entityManager;

// 构建History并关联Status
History history = new History();

Task task = new Task();
task.setId(dto.getId());
history.setTaskId(task);

// 通过自然ID获取Status代理实例
Status status = entityManager.unwrap(Session.class)
        .byNaturalId(Status.class)
        .using("statusCode", dto.getStatus())
        .load();

history.setStatus(status);
historyRepository.save(history);

方案2：直接映射外键字段（绕过实体关联） #

如果不需要通过History实体操作Status，可以在History中直接添加对应外键的字段，配合insertable=false, updatable=false避免字段冲突：

@Entity
public class History {
    @Id
    @Column(unique = true, nullable = false)
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "task_id")
    private Task taskId;

    // 直接映射外键字段
    @Column(name = "status")
    private Short statusCode;

    // 保留实体关联（可选，若需后续访问Status实体则保留）
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "status", referencedColumnName = "status_code", insertable = false, updatable = false)
    private Status status;

    // 新增setter
    public void setStatusCode(Short statusCode) {
        this.statusCode = statusCode;
    }
}

保存时直接设置statusCode即可，无需创建Status实例：

History history = new History();

Task task = new Task();
task.setId(dto.getId());
history.setTaskId(task);

// 直接设置外键值
history.setStatusCode(dto.getStatus());

historyRepository.save(history);

方案3：原生SQL/JPQL插入 #

如果追求极简，可以在HistoryRepository中定义原生SQL插入方法，直接传入参数完成保存：

public interface HistoryRepository extends JpaRepository<History, Long> {
    @Modifying
    @Query(value = "INSERT INTO history (task_id, status) VALUES (:taskId, :statusCode)", nativeQuery = true)
    void saveHistory(@Param("taskId") Long taskId, @Param("statusCode") Short statusCode);
}

调用时只需传入参数：

historyRepository.saveHistory(dto.getId(), dto.getStatus());

• Task的关联字段是主键id，当你创建Task实例并设置id时，Hibernate会将其视为对应数据库中已存在记录的托管实例，因此保存History时只会建立外键关联，不会尝试保存Task。
• 而Status的关联字段是非主键status_code，Hibernate默认仅通过主键识别实体是否已持久化。你创建的Status实例未设置主键id，Hibernate会判定这是未保存的瞬态实例，因此抛出TransientPropertyValueException要求先保存Status。

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