EclipseLink中@JoinColumns关联查询问题：顶级组织查询异常求助

你遇到的问题根源在于多列关联的JPA默认行为：
当你用@JoinColumns定义多字段关联时，JPA规范要求：如果关联实体（这里的parent）为null，所有关联列都会被添加IS NULL的查询条件。

而你的第二个@JoinColumn绑定了当前表的ORG_ID字段，且该字段被设置为nullable=false（本身不允许为空），所以生成的SQL会出现PARENT_ID IS NULL AND ORG_ID IS NULL的矛盾条件——既要求ORG_ID非空（表约束），又要求它为null（关联null判断），自然查不到正确的顶级组织。

根据你的业务需求，有几种可行的处理方式：

方案1：移除不必要的关联列（推荐） #

如果ORG_ID并非父实体主键的一部分，只是为了利用(PARENT_ID, ORG_ID)复合索引提升查询速度，完全不需要把它加入关联注解。你可以直接在实体上定义复合索引，让EclipseLink自动利用索引优化查询：

@Entity
@Table(indexes = @Index(name = "idx_parent_org", columnList = "PARENT_ID, ORG_ID"))
public class Organization {
    // 其他字段定义...
    
    @JoinColumn(name = "PARENT_ID")
    private Organization parent;
}

这种方式下，查询顶级组织时只会生成PARENT_ID IS NULL的条件，同时关联查询仍会自动使用复合索引，兼顾需求和性能。

方案2：用EclipseLink扩展注解处理null条件 #

如果必须保留多列关联，可以使用EclipseLink专属的@JoinColumnsOrFormulas注解，指定关联为null时不对ORG_ID添加无效的null判断：

import org.eclipse.persistence.annotations.JoinColumnOrFormula;
import org.eclipse.persistence.annotations.JoinColumnsOrFormulas;
import org.eclipse.persistence.annotations.JoinFormula;

// 实体类其他部分...

@JoinColumnsOrFormulas({
    @JoinColumnOrFormula(column = @JoinColumn(name = "PARENT_ID")),
    @JoinColumnOrFormula(formula = @JoinFormula(
        value = "ORG_ID",
        referencedColumnName = "ORG_ID",
        whenNull = "ORG_ID"
    ))
})
private Organization parent;

whenNull参数指定了当parent为null时，该列的匹配值为当前实体的ORG_ID，最终生成的条件会变成PARENT_ID IS NULL AND ORG_ID = ORG_ID（等价于只判断PARENT_ID为null）。

方案3：自定义查询绕过默认条件 #

如果不想修改实体注解，可以在查询顶级组织时，手动编写JPQL或原生SQL：

// JPQL示例
List<Organization> topOrgs = entityManager.createQuery(
    "SELECT o FROM Organization o WHERE o.parent IS NULL",
    Organization.class
).getResultList();

// 原生SQL示例（适合复杂场景）
List<Organization> topOrgs = entityManager.createNativeQuery(
    "SELECT * FROM ORGANIZATION WHERE PARENT_ID IS NULL",
    Organization.class
).getResultList();

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