JPA映射互存外键且无关联表的两张Oracle表实体方案

此前配置失败的核心原因是混淆了「两个独立外键关联」和「单个关联的双向映射」的边界：两张表互相持有外键本质是两个独立的多对一/一对多关联，而非单个关联的正反两端，既不符合@ManyToMany的多对多场景逻辑，也不能在两侧都将@OneToMany作为关联持有端配置。

核心配置规则 #

• 关联持有端（外键所在表对应的实体侧）：每个表上的外键字段对应本实体的@ManyToOne属性，通过@JoinColumn明确指定本表里的外键列名、关联的对方表主键列名，这一侧不配置mappedBy，是实际负责外键值读写的一端。
• 反向集合端（无外键的集合属性侧）：每个实体上存储对方实体集合的属性，使用@OneToMany注解，必须通过mappedBy指定对方实体里对应关联持有端的属性名，这一侧不要添加@JoinColumn，否则JPA会错误识别为关联持有端，尝试查找不存在的字段或自动生成多余的中间关联表。

代码实现示例 #

假设表A的外键列名为b_id指向表B主键，表B的外键列名为a_id指向表A主键，实体配置如下：

表A对应实体：

@Entity
@Table(name = "TABLE_A")
public class TableA {
    @Id
    @Column(name = "ID")
    private Long id;

    // 持有端：A表自身存的指向B的外键
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "B_ID", referencedColumnName = "ID")
    private TableB directRefB;

    // 反向端：所有外键指向当前A记录的B记录集合，mappedBy指向B实体中关联A的持有端属性名
    @OneToMany(mappedBy = "directRefA", fetch = FetchType.LAZY)
    private Set<TableB> refCurrentABs = new HashSet<>();

    // 省略getter、setter方法
}

表B对应实体：

@Entity
@Table(name = "TABLE_B")
public class TableB {
    @Id
    @Column(name = "ID")
    private Long id;

    // 持有端：B表自身存的指向A的外键
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "A_ID", referencedColumnName = "ID")
    private TableA directRefA;

    // 反向端：所有外键指向当前B记录的A记录集合，mappedBy指向A实体中关联B的持有端属性名
    @OneToMany(mappedBy = "directRefB", fetch = FetchType.LAZY)
    private Set<TableA> refCurrentBAs = new HashSet<>();

    // 省略getter、setter方法
}

注意事项 #

1. 如果数据库中外键字段允许为NULL，需要在对应@JoinColumn上添加nullable = true属性，和数据库实际约束保持一致即可，不需要额外特殊配置。
2. 维护双向关联关系时，需要同步设置两侧的属性值：例如给A对象设置directRefB为某个B对象时，也要同步把该A对象加入B对象的refCurrentBAs集合，避免持久化上下文内对象状态不一致导致的查询数据错误。
3. 不要尝试在@OneToMany侧配置@JoinColumn，该配置会让JPA将这一侧判定为关联持有端，直接去当前实体对应的数据表中查找不存在的外键列，抛出Schema映射错误。

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