Spring Boot JPA(PostgreSQL)复合列WHERE IN原生查询报错解决

这个错误本质是你在原生查询里把行记录（比如(first_name, last_name)）直接和字符串数组做了不兼容的类型对比，PostgreSQL不支持这种跨类型的匹配。下面给你几种无需concat的高效解决方案，按需选择：

场景1：匹配first_name或last_name在目标数组中 #

如果需求是只要名字或姓氏在给定数组里就返回，直接用ANY操作符分别判断字段，能利用字段索引（如果有），性能远优于concat：

仓库方法代码 #

@Repository
public interface UsersRepo extends JpaRepository<UsersEntity, Long> {
    @Query(value = "SELECT * FROM users WHERE first_name = ANY(:names) OR last_name = ANY(:names)", nativeQuery = true)
    List<UsersEntity> findAllByCustom(@Param("names") String[] names);
}

说明 #

ANY(:names)会把数组中的每个元素依次和字段对比，PostgreSQL能直接利用first_name或last_name上的索引，执行计划成本极低。

场景2：匹配first_name和last_name的成对组合 #

如果需求是找名字+姓氏完全匹配给定组合的用户（比如要找("Alice", "Smith")、("Bob", "Jones")这类用户），可以用行构造器结合ANY，同时传入二维数组参数：

仓库方法代码 #

@Repository
public interface UsersRepo extends JpaRepository<UsersEntity, Long> {
    @Query(value = "SELECT * FROM users WHERE (first_name, last_name) = ANY(:namePairs)", nativeQuery = true)
    List<UsersEntity> findAllByCustom(@Param("namePairs") String[][] namePairs);
}

调用示例 #

String[][] pairs = {{"Alice", "Smith"}, {"Bob", "Jones"}};
List<UsersEntity> users = usersRepo.findAllByCustom(pairs);

说明 #

这里的(first_name, last_name)是行记录，ANY(:namePairs)会遍历二维数组中的每个子数组，将其转为行记录后对比，完全避免字符串拼接，性能最优。

场景3：匹配名字+姓氏组成的数组与目标数组一致 #

如果需求是找[first_name, last_name]这个数组和目标数组完全相等的用户（比如匹配数组["Alice", "Smith"]），可以直接构造数组对比：

仓库方法代码 #

@Repository
public interface UsersRepo extends JpaRepository<UsersEntity, Long> {
    @Query(value = "SELECT * FROM users WHERE ARRAY[first_name, last_name] = ANY(:nameArrays)", nativeQuery = true)
    List<UsersEntity> findAllByCustom(@Param("nameArrays") String[][] nameArrays);
}

关键注意事项 #

• 确保参数类型和SQL表达式类型匹配：比如传入String[]对应PostgreSQL的text[]，String[][]对应text[][]
• 优先利用字段索引：上述方案都能触发索引扫描（如果字段上建了索引），而concat会导致全表扫描
• 避免隐式类型转换：不要直接把行记录和字符串数组对比，必须构造相同类型的表达式（行对行、数组对数组）

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