如何在JPA中创建原生查询？使用PostgreSQL jsonb操作符时出现语法错误的原因排查

我明白你遇到的问题了——JPA的原生查询语法和PostgreSQL的jsonb操作符撞车了，导致了这个语法错误。下面我来拆解原因和解决方案：

错误原因 #

JPA在处理原生查询时，会把?识别为参数占位符，自动替换成PostgreSQL的位置参数$1。你原本写的tags ? 'somestring'会被JPA转换成tags $1 'somestring'，这显然不符合PostgreSQL的语法规则，所以才会抛出syntax error at or near "$1"的错误。

PostgreSQL的?、?|、@>这些jsonb操作符，和JPA的参数占位符语法冲突了，不能直接在JPA原生查询里这么写。

解决方案：用函数替代操作符 #

PostgreSQL为所有jsonb操作符都提供了对应的函数形式，我们可以用这些函数来避免语法冲突，同时实现相同的功能：

操作符与函数对应关系 #

你的查询修改示例 #

针对你要检查tags数组是否包含'somestring'的需求，把查询改成用jsonb_exists函数即可：

@Query(value = "SELECT item FROM catalog_cache WHERE jsonb_exists(tags, ?1)", nativeQuery = true)
List<CatalogCache> findItemsWithTag(String tag);

如果需要参数化传递要检查的字符串，上面的写法完全支持，JPA会把?1正确解析为参数占位符，不会和函数调用冲突。

其他操作符的使用示例 #

• 检查tags数组是否包含'tag1'或'tag2'：

@Query(value = "SELECT item FROM catalog_cache WHERE jsonb_exists_any(tags, ARRAY[?1, ?2])", nativeQuery = true)
List<CatalogCache> findItemsWithAnyTag(String tag1, String tag2);

• 检查tags是否包含某个jsonb对象（比如{"name": "test"}）：

@Query(value = "SELECT item FROM catalog_cache WHERE jsonb_contains(tags, ?1::jsonb)", nativeQuery = true)
List<CatalogCache> findItemsContainingJson(String jsonStr);

这样修改后，JPA就能正确解析查询，PostgreSQL也能正常执行jsonb的判断逻辑了。

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