Java Spring JPA：如何正确映射多表与OneToMany关联

一、这种设计是否属于良好数据库实践？ #

你提到的将主表主键作为子表主键的一部分（或全部）的设计，属于共享主键关联模式，是合理且符合规范的数据库设计方案，核心适用于子表实体完全依赖主表、无独立存在意义的场景：

• 适用场景：比如用户档案依赖用户存在、订单详情依赖订单存在，删除主表记录时子表记录必须同步删除的强关联场景。
• 不适用场景：如果子表实体可脱离主表单独存在，或未来可能需要关联多个主表，这种设计会限制扩展性，此时更适合用普通非主键外键关联。

二、Spring Boot中的实现方案 #

完全可以实现，核心是通过JPA的复合主键注解结合单向关联（主表不维护子表列表）来实现，以下分两种典型场景给出代码示例：

场景1：子表主键完全复用主表主键（一对一强关联） #

比如User主表和UserProfile子表，用户档案的主键就是用户ID。

主表实体（User）

@Entity
@Table(name = "user")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long userId;
    private String username;
    private String email;

    // 不定义子表集合，满足你"不想存储其他表列表"的需求
    // getter、setter省略
}

子表实体（UserProfile）

@Entity
@Table(name = "user_profile")
public class UserProfile {
    @Id
    private Long userId; // 直接复用User的主键作为自身主键

    @OneToOne(fetch = FetchType.LAZY)
    @MapsId // 关键注解：将关联的User主键映射为当前实体的主键
    @JoinColumn(name = "user_id")
    private User user;

    private String address;
    private String phone;

    // getter、setter省略
}

场景2：子表主键包含主表主键（一对多复合主键） #

比如Order主表和OrderItem子表，订单项主键由orderId（订单ID）和itemId（订单项ID）组成。

复合主键类（必须实现Serializable）

public class OrderItemId implements Serializable {
    private Long orderId;
    private Long itemId;

    // 必须提供无参构造、全参构造，重写equals和hashCode
    public OrderItemId() {}
    public OrderItemId(Long orderId, Long itemId) {
        this.orderId = orderId;
        this.itemId = itemId;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        OrderItemId that = (OrderItemId) o;
        return Objects.equals(orderId, that.orderId) && Objects.equals(itemId, that.itemId);
    }

    @Override
    public int hashCode() {
        return Objects.hash(orderId, itemId);
    }

    // getter、setter省略
}

主表实体（Order）

@Entity
@Table(name = "`order`") // 注意order是SQL关键字，需要用反引号转义
public class Order {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long orderId;
    private LocalDateTime createTime;
    private BigDecimal totalAmount;

    // 不定义订单项集合，满足需求
    // getter、setter省略
}

子表实体（OrderItem）

@Entity
@Table(name = "order_item")
@IdClass(OrderItemId.class) // 指定复合主键类
public class OrderItem {
    @Id
    private Long orderId; // 主表Order的主键，作为复合主键一部分

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long itemId; // 订单项自身唯一标识，复合主键另一部分

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "order_id", insertable = false, updatable = false)
    // 设为false避免重复维护orderId字段，防止冲突
    private Order order;

    private String productName;
    private Integer quantity;
    private BigDecimal price;

    // getter、setter省略
}

关键注解说明 #

• @MapsId：一对一共享主键场景专用，自动将主表主键映射为子表主键，无需手动赋值。
• @IdClass：复合主键场景使用，指定包含主键字段的序列化类，类中字段需与实体主键字段名完全一致。
• @ManyToOne/@OneToOne：仅在子表定义关联关系，主表不维护子表集合，完美匹配你不想存储子表列表的需求。
• FetchType.LAZY：建议设置为懒加载，避免不必要的关联查询，提升性能。

注意事项 #

1. 复合主键类必须实现Serializable，并重写equals和hashCode，JPA依赖这两个方法判断实体唯一性。
2. 当主键字段同时作为外键时，需将@JoinColumn的insertable和updatable设为false，避免JPA重复操作该字段引发异常。

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