JPA原生查询向IN子句传入List时触发「无效列类型」错误

问题分析 #

你的JPA原生查询使用位置参数?1绑定List集合时，触发了Oracle JDBC的Invalid column type错误，核心原因通常是参数绑定方式不兼容、类型不匹配或框架解析问题。

解决方案 #

1. 改用命名参数绑定 #

位置参数在EclipseLink处理原生查询的集合参数时易出现解析异常，换成命名参数并配合@Param注解可解决：

import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import java.util.List;

// ...
@Query(
    value = "select distinct ID_RIGHT from TDK_SEC_HOTEL_RIGHT osrr where osrr.ID_RIGHT in :hotels", 
    nativeQuery = true
)
List<String> findAllByHOTELs(@Param("hotels") List<String> HOTELs);

2. 匹配数据库字段与参数类型 #

Invalid column type最常见的原因是参数类型和数据库ID_RIGHT字段类型不匹配：

• 若数据库中ID_RIGHT为数值类型（如NUMBER），需将方法参数改为List<Integer>或List<Long>，同时调整返回值类型为对应数值集合；
• 若字段为字符串类型（如VARCHAR2），确认传入的List<String>元素格式符合字段要求，无非法类型转换。

3. 验证驱动与框架兼容性 #

检查Oracle JDBC驱动版本是否与当前EclipseLink版本（2.7.5）兼容，建议升级驱动至匹配版本（如Oracle JDBC 19c适配EclipseLink 2.7.x）。

4. 开启EclipseLink集合参数支持（若需） #

若仍存在解析问题，可在persistence.xml中添加EclipseLink配置，强制启用集合参数处理：

<properties>
    <property name="eclipselink.jdbc.bind-parameters" value="true"/>
    <property name="eclipselink.query-results-cache" value="false"/>
</properties>

内容的提问来源于stack exchange，提问作者Nunyet Calçada