如何解决JPA Joined继承中多子类同名属性的关联查询异常？

当使用@Inheritance(strategy = InheritanceType.JOINED)时，父类Root无法直接关联子类独有的同名属性，因为JPA无法确定该属性属于哪个子类。以下是两种可行的解决方案：

方案一：使用treat API强制转换为目标子类 #

JPA 2.1引入的treat方法可以将父类型的Root转换为指定子类，从而明确指定要访问的子类属性：

private static void createJoin(List<Predicate> predicates, CriteriaBuilder cb, Root<Parent> root) {
    // 关联ChildOne的field属性
    Root<ChildOne> childOneRoot = cb.treat(root, ChildOne.class);
    Join<ChildOne, RelationClass> childOneJoin = childOneRoot.join("field", JoinType.LEFT);
    
    // 如果需要同时处理ChildTwo的field，单独转换后关联
    Root<ChildTwo> childTwoRoot = cb.treat(root, ChildTwo.class);
    Join<ChildTwo, RelationClass> childTwoJoin = childTwoRoot.join("field", JoinType.LEFT);
    
    // 后续可根据业务需求组合两个join的查询条件
}

treat方法不会改变查询的根实体类型，只是告诉JPA要将当前Root视为指定子类，从而可以安全访问子类的属性，解决属性歧义问题。

方案二：在父类中声明共享属性（适合同名属性语义一致的场景） #

如果两个子类的field属性语义相同，可以在父类中统一声明该属性，子类按需覆盖映射配置：

修改父类Parent： #

@Entity
@Table(schema = "example", name = "parent")
@Inheritance(strategy = InheritanceType.JOINED)
public class Parent {
    @ManyToOne
    @JoinColumn(name = "relation_id", insertable = false, updatable = false)
    protected RelationClass field;
    
    // 其他属性及方法...
}

子类ChildOne（ChildTwo同理）： #

@Entity
@Table(schema = "example", name = "child_one")
public class ChildOne extends Parent {
    // 覆盖父类属性，设置可插入/更新（因为父类中设为false）
    @Override
    @ManyToOne
    @JoinColumn(name = "relation_id")
    public RelationClass getField() {
        return super.getField();
    }
    
    // 其他属性及方法...
}

这种方式下，父类已经包含field属性的元数据，直接通过root.join("field")即可完成关联，无需处理子类歧义。

问题原因说明 #

在JOINED继承策略中，父类和子类对应独立的数据库表，子类的属性不属于父类的映射元数据。当通过父类Root访问同名子类属性时，JPA发现多个子类都存在该属性，无法确定要关联哪个子类的表，因此抛出InvalidDataAccessResourceUsageException异常。

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