相同JPA @Query在Hibernate正常运行但EclipseLink不生效问题咨询

• Hibernate作为JPA提供商对JPQL语法做了额外的增强实现：当检测到IN子句左侧是复合主键类型的属性时，会自动识别右侧传入的集合参数，将集合内的每个复合主键实例自动映射为多字段匹配结构，不需要手动展开字段，因此你写的DELETE FROM MyEntity me WHERE me.id in (:ids)可以直接运行。
• EclipseLink采用严格符合JPA规范的最小实现逻辑：参数解析时只会匹配属性的直接类型，检测到me.id的类型是MyIdClass，就会默认要求:ids参数是单个MyIdClass实例，不会主动识别该参数是用于IN子句的集合，因此会抛出集合类型和预期MyIdClass不匹配的错误。

• 方案1（最便捷，无侵入）：手动展开复合主键的字段编写JPQL。假设MyIdClass由field1、field2两个主键字段组成，将查询语句修改为：

  DELETE FROM MyEntity me WHERE (me.id.field1, me.id.field2) IN (:ids)
  

  该写法完全符合JPA规范，同时兼容Hibernate和EclipseLink两种提供商，不需要修改业务层传参逻辑。
• 方案2（兼容性最强）：使用Criteria API构建批量删除逻辑，手动指定复合主键的多字段匹配规则，避免JPQL解析差异问题。
• 方案3（临时兼容）：如果不想修改JPQL，可将传入的ids集合先转换为List<Object[]>，每个数组元素按顺序对应MyIdClass的主键字段值，EclipseLink可直接识别该类型的集合参数。

该差异属于两款JPA提供商的设计选择，不存在bug：

• JPA规范没有强制要求提供商必须支持复合主键集合直接传入IN子句的语法，Hibernate的实现属于额外的易用性增强
• EclipseLink的严格解析逻辑完全符合JPA规范的最低要求，属于预期行为，归属EclipseLink本身的设计实现。

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