EclipseLink与Hibernate的JPQL差异：关联查询报错求助

这个问题我之前也遇到过，本质是Hibernate对JPQL的语法解析比EclipseLink更严格，尤其是处理带有@IdClass的复合主键关联时。

错误原因分析 #

你收到的报错left and right hand sides of a binary logic operator were incompatible [integer : component[node,parent]]，是因为Hibernate把ra.parent.id和ra.node.id的解析和复合主键绑定到了一起。在@IdClass的映射下，Hibernate会把RoleAssociation的主键视为一个整体组件（component），而不是单独的关联字段，所以直接通过ra.parent.id进行关联判断时，类型匹配就出了问题。

解决方案一：修改JPQL为基于实体关联的查询 #

最简单的修复方式是调整JPQL语句，利用已经定义好的实体关联关系来查询，而不是手动写JOIN ON条件。

你可以把原来的命名查询改成：

@NamedQuery(name = "Role.findParents", query = "SELECT ra.parent FROM Role r JOIN r.parentRoles ra WHERE r.id = :id")

这个写法完全符合JPA规范：

• 从指定id的Role出发，关联它的parentRoles集合（也就是RoleAssociation实例）
• 直接取出每个关联实例的parent属性，就是你要的父角色列表

这种写法不仅能让Hibernate正确解析，还更简洁易读，也兼容所有JPA实现（包括EclipseLink）。

解决方案二：调整实体映射为@EmbeddedId（可选） #

如果你坚持要保留原来的JOIN ON写法，可以把@IdClass换成@EmbeddedId，让Hibernate更清晰地识别复合主键和关联字段的关系：

1. 先修改主键类为嵌入式：

@Embeddable
@Data
class RoleAssociationKey implements Serializable {
    private static final long serialVersionUID = 1L;
    @Column(name = "has_parent_role_id")
    private Integer nodeId;
    @Column(name = "is_parent_for_role_id")
    private Integer parentId;
}

2. 然后修改RoleAssociation实体：

@Table(name = "role__parent")
@Data
public class RoleAssociation implements Serializable {
    @EmbeddedId
    private RoleAssociationKey id;

    @ManyToOne
    @JoinColumn(name = "has_parent_role_id", insertable = false, updatable = false)
    private Role node;

    @ManyToOne
    @JoinColumn(name = "is_parent_for_role_id", insertable = false, updatable = false)
    private Role parent;
    // ... 其他字段
}

3. 最后调整JPQL查询，直接使用复合主键里的字段：

@NamedQuery(name = "Role.findParents", query = "SELECT r FROM Role r JOIN RoleAssociation ra ON r.id = ra.id.parentId WHERE ra.id.nodeId = :id")

这种方式需要修改实体映射，但能让复合主键的结构更清晰，Hibernate也能正确解析字段关联。

为什么EclipseLink可以运行？ #

不同JPA实现对JPQL的宽松程度不同，EclipseLink可能做了额外的语法兼容，自动将ra.parent.id解析为关联实体的id字段；而Hibernate更严格遵循JPA规范，要求查询语句必须明确对应映射关系，所以会抛出类型不兼容的错误。

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