EclipseLink JPA JOINED继承策略复合主键JOIN关联异常

这是EclipseLink的固有解析bug，不属于配置遗漏。
触发该bug的必要条件：

• 超类实体使用@IdClass定义复合主键，且复合主键中直接将@ManyToOne/@OneToOne类型的关联字段标记为@Id
• 实体继承策略配置为InheritanceType.JOINED

该bug的触发逻辑是：EclipseLink在扫描JOINED继承策略的子类元模型时，不会正确识别超类中关联类型的主键字段，会错误判定实体使用单主键：

• 自动生成表关联SQL时，仅会匹配非关联类型的主键字段（即当前场景中的numero字段），缺失关联类型主键的关联条件，产生笛卡尔积返回错误结果
• 手动在子类添加@PrimaryKeyJoinColumns声明多字段关联时，会直接抛出*“实体使用单主键，不允许多个主键关联配置”*的启动错误

根据实际场景可选择以下任意一种方案：

方案1：升级EclipseLink版本（成本最低） #

该bug已在以下官方版本中修复：

• 2.7.x分支：2.7.10及以上补丁版本
• 3.x分支：3.0.0及以上正式版本

升级后不需要修改原有超类的主键定义，仅需在子类上正常添加之前写的@PrimaryKeyJoinColumns配置即可，启动不会报错，框架会自动生成包含tipo_mision、numero两个字段的完整关联条件。

方案2：改造复合主键实现（兼容所有版本） #

如果暂时无法升级EclipseLink版本，按照JPA规范推荐的方式改造复合主键定义，将@IdClass替换为@EmbeddedId，通过@MapsId映射关联字段，可绕开该解析bug。

1. 定义可嵌入的主键类：

@Embeddable
public class TipoOpcionMisionId implements Serializable {
    // 字段类型对应TipoMision实体的主键类型，示例中假设为String
    private String tipoMisionId;
    private int numero;

    public TipoOpcionMisionId() {}

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

    @Override
    public int hashCode() {
        return Objects.hash(tipoMisionId, numero);
    }
}

2. 修改超类实体的主键映射：

@Entity
@Table(name = "tipos_opciones_misiones")
@Inheritance(strategy = InheritanceType.JOINED)
@DiscriminatorColumn(name = "clase", discriminatorType = DiscriminatorType.STRING)
@ReadOnly
public abstract class TipoOpcionMision{
    @EmbeddedId
    private TipoOpcionMisionId id;

    @ManyToOne
    @MapsId("tipoMisionId")
    @JoinColumn(name="tipo_mision")
    private TipoMision tipoMision;

    @Id
    @Column(name = "numero")
    private int numero;
}

改造后子类不需要额外添加@PrimaryKeyJoinColumns配置，EclipseLink可以正确识别复合主键结构，自动生成完整的表关联条件。

注意：不要尝试通过自定义SQL、查询提示等方式临时规避该问题，只要元模型解析错误，所有涉及子类的多态查询、关联查询都会出现条件缺失的问题，必须从元模型定义或版本层面解决。

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