EclipseLink升级中QueryImpl.unwrap()抛出NullPointerException求助

根源定位 #

你遇到的NullPointerException是Spring Data JPA 2.7.11与EclipseLink 2.6.4的兼容性冲突导致的：

• Spring Data JPA 2.7.x版本的QueryParameterSetter$BindableQuery初始化时，会调用query.unwrap(null)尝试获取底层查询实例；
• 但EclipseLink 2.6.4的QueryImpl.unwrap()方法在传入null参数时直接返回null，而非返回查询对象本身，后续代码调用null对象的方法触发了空指针异常。

解决方法 #

1. 升级EclipseLink版本（推荐方案） #

EclipseLink 2.6.4属于老旧版本，与Spring Data JPA 2.7.x（基于JPA 2.2规范）兼容性不足。建议升级到EclipseLink 2.7.x系列稳定版（如2.7.10）：该版本修复了unwrap(null)的逻辑，会正确返回查询对象本身，同时完全兼容JPA 2.2，能匹配Spring Data JPA 2.7.11的要求。

2. 修改JPQL查询写法（临时绕过） #

将原查询中的隐式连接改为显式JOIN，可能触发Spring Data JPA不同的参数绑定逻辑，绕过unwrap(null)的调用：

@Query("select d from Dossier d JOIN d.allotements a where a.lot = :lot order by d.id desc")
public List<Dossier> getDossiersPourUnLot(@Param("lot") Lot lot);

3. 手动实现Repository方法（彻底规避） #

如果无法升级依赖，可在Repository实现类中直接使用EntityManager执行查询，绕过Spring Data的自动参数绑定逻辑：

@Repository
public class DossierRepositoryImpl implements DossierRepositoryCustom {

    @PersistenceContext
    private EntityManager em;

    @Override
    public List<Dossier> getDossiersPourUnLot(Lot lot) {
        TypedQuery<Dossier> query = em.createQuery(
            "select d from Dossier d join d.allotements a where a.lot = :lot order by d.id desc",
            Dossier.class
        );
        query.setParameter("lot", lot);
        return query.getResultList();
    }
}

（需先定义DossierRepositoryCustom接口，让主Repository接口继承它）

4. 自定义Spring Data扩展（进阶方案） #

若必须保留Spring Data的@Query注解，可自定义QueryParameterSetter实现，替换默认的BindableQuery逻辑，避免传入null调用unwrap()。此方法需要熟悉Spring Data JPA内部逻辑，适合有框架定制经验的场景。

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