JPA原生查询Postgres数组包含值报错：integer[] @> character varying类型不匹配

嘿，我碰到过一模一样的坑，这就给你把问题捋明白、搞定它！

问题根源 #

你看到的错误 ERROR: operator does not exist: integer[] @> character varying 核心就是类型不匹配：

• 数据库里的列是 integer[] 类型
• 但Java应用传递的参数是字符串（character varying）类型
• 为啥DBeaver里能正常跑？因为你手动输入的数字会被工具自动识别成integer类型，自然不会有类型冲突。

两种实用解决方案 #

方案1：传递正确类型的参数

直接在Java代码里传Integer类型的参数，而非String，再调整查询语句让参数匹配数组类型：

@Query(value = "SELECT * FROM your_table WHERE integer_array_column @> ARRAY[?1]::INTEGER[]", nativeQuery = true)
List<YourEntity> findByValueInArray(Integer targetValue);

这样JPA会把参数正确映射为PostgreSQL的integer类型，@>操作符两边都是整数数组相关类型，就能正常执行了。

方案2：显式转换参数类型

如果因为业务限制必须传String类型参数，那就在查询里把字符串转成integer再使用：

@Query(value = "SELECT * FROM your_table WHERE integer_array_column @> ARRAY[CAST(?1 AS INTEGER)]::INTEGER[]", nativeQuery = true)
List<YourEntity> findByValueInArray(String targetValue);

这里用CAST(?1 AS INTEGER)把输入的字符串转成整数，再包裹成整数数组和列进行匹配。

备选：用= ANY操作符简化写法

如果你只是要检查某个值是否存在于数组中，用= ANY会更直观，同样要注意类型匹配：

// 传递Integer参数的写法
@Query(value = "SELECT * FROM your_table WHERE ?1 = ANY(integer_array_column)", nativeQuery = true)
List<YourEntity> findByValueInArray(Integer targetValue);

// 传递String参数时的转换写法
@Query(value = "SELECT * FROM your_table WHERE CAST(?1 AS INTEGER) = ANY(integer_array_column)", nativeQuery = true)
List<YourEntity> findByValueInArray(String targetValue);

小技巧：验证参数传递 #

你可以开启Java应用的SQL日志，看看实际执行的SQL语句和参数类型，确认参数是否被正确传递，这样排查问题会更高效！

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