如何基于Spring Data JPA+Hibernate实现非主键间One-To-Many关联

问题核心原因 #

你当前的关联逻辑是基于自增主键id做关联，但是表设计里外键是基于业务唯一标识（hotel_id、room_type_id）做关联，且同一个业务ID会有多条历史版本记录，所以需要调整映射规则：

1. 补全实体基础字段 #

首先把所有业务字段、业务唯一标识补到对应实体中，主键生成策略用IDENTITY适配PostgreSQL的BIGSERIAL类型：

@Entity
@Table(name = "hotels")
public class Hotel { 
   @Id
   @GeneratedValue(strategy = GenerationType.IDENTITY)
   private Long id;

   @Column(name = "hotel_id", nullable = false)
   private UUID hotelId;

   @Column(name = "hotel_name")
   private String hotelName;

   // 其他业务字段：地址、星级等
}

@Entity
@Table(name = "room_types")
public class RoomType {
   @Id
   @GeneratedValue(strategy = GenerationType.IDENTITY)
   private Long id;

   @Column(name = "hotel_id", nullable = false)
   private UUID hotelId;

   @Column(name = "room_type_id", nullable = false)
   private UUID roomTypeId;

   @Column(name = "room_name")
   private String roomName;

   // 其他业务字段：价格、面积等
}

@Entity
@Table(name = "rooms")
public class Room {
   @Id
   @GeneratedValue(strategy = GenerationType.IDENTITY)
   private Long id;

   @Column(name = "room_type_id", nullable = false)
   private UUID roomTypeId;

   @Column(name = "room_id", nullable = false)
   private UUID roomId;

   // 其他业务字段：楼层、房号等
}

2. 调整关联关系映射 #

因为关联的是对方表的非主键业务字段，需要明确指定referencedColumnName为对应的业务字段名，设置insertable = false, updatable = false避免字段重复映射：

Hotel实体一对多关联RoomType

@Entity
@Table(name = "hotels")
public class Hotel { 
   // 基础字段省略

   // 关联同一个hotel_id对应的所有房型历史记录
   @OneToMany
   @JoinColumn(name = "hotel_id", referencedColumnName = "hotel_id", insertable = false, updatable = false)
   private Set<RoomType> roomTypes;
}

RoomType实体多对一关联Hotel

@Entity
@Table(name = "room_types")
public class RoomType {
   // 基础字段省略

   // 关联同一个hotel_id对应的所有酒店历史记录
   @ManyToOne
   @JoinColumn(name = "hotel_id", referencedColumnName = "hotel_id", insertable = false, updatable = false)
   private Set<Hotel> hotels;
}

RoomType和Room的关联逻辑完全同上，把关联字段换成room_type_id即可。

3. 历史版本场景适配 #

如果业务只需要关联最新版本的实体，不需要返回所有历史记录，可选两种方案：

• 加过滤注解：在关联集合上加@Where(clause = "id = (select max(id) from hotels h where h.hotel_id = hotel_id)")，自动过滤出最大ID对应的最新版本
• 自定义JPQL查询：直接按业务ID+最大ID条件查询，灵活度更高，也避免多余历史数据加载

如果不需要实体级的关联，也可以只保留业务ID字段，查询时手动按业务ID关联，适配性更强。

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