Spring Boot 3集成EclipseLink时命名与索引参数失效问题

针对你遇到的Query.setParameter()无法识别命名参数（:param）或带编号索引参数（?1）、仅无编号?可用的问题，可按以下步骤解决：

1. 确保版本兼容 #

Spring Boot 3要求EclipseLink版本至少为3.0.x，建议使用3.0.4及以上版本，Maven依赖配置如下：

<dependency>
    <groupId>org.eclipse.persistence</groupId>
    <artifactId>org.eclipse.persistence.jpa</artifactId>
    <version>3.0.4</version>
</dependency>

2. 开启原生查询命名参数支持 #

EclipseLink默认对原生SQL的命名参数解析是关闭的，需在application.properties中显式开启：

# 开启原生SQL命名参数解析
spring.jpa.properties.eclipselink.native.sql.named-parameters=true
# 强制开启参数绑定（默认开启，显式配置避免异常）
spring.jpa.properties.eclipselink.jdbc.bind-parameters=true

3. 适配Spring Data JPA的EclipseLink实现 #

使用@Query注解时，Spring Data JPA默认的Hibernate适配逻辑会导致参数绑定异常，需配置专门的EclipseLink Repository工厂：

import org.springframework.context.annotation.Configuration;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
import org.springframework.data.jpa.repository.support.EclipseLinkJpaRepositoryFactoryBean;

@Configuration
@EnableJpaRepositories(
    basePackages = "com.yourproject.repository", // 替换为你的Repository包路径
    repositoryFactoryBeanClass = EclipseLinkJpaRepositoryFactoryBean.class
)
public class JpaConfig {
}

4. 手动创建Query时的额外处理 #

如果是通过EntityManager手动构建查询，可直接给Query添加Hint强制开启命名参数：

Query query = this.entityManager.createNativeQuery(sql, "SomeDtoMapping");
query.setHint("eclipselink.native.sql.named-parameters", true);
query.setParameter("someAttr", someAttr);

为什么无编号?能正常工作？ #

无编号的?是JDBC原生位置参数，EclipseLink会直接将其传递给JDBC驱动，无需额外解析；而命名参数和带编号的?1需要EclipseLink先完成参数映射，必须开启对应的配置才能生效。

内容的提问来源于stack exchange，提问作者eniel.rod