Spring Data原生查询无法使用PostgreSQL jsonb字符串存在运算符(?)

你遇到的问题核心在于：Spring Data JPA的原生查询解析器会优先把SQL里的?识别为参数占位符，哪怕你用\\?转义，在部分框架版本里还是会触发解析冲突，最终导致PostgreSQL抛出参数不匹配的PSQLException。下面给你几个靠谱的解决方案：

方案1：用PostgreSQL内置函数替代运算符（最推荐） #

直接使用PostgreSQL提供的jsonb_exists函数，它和?运算符功能完全一致，但不会和参数占位符产生冲突：

@Query(value = "SELECT t.id \n" + 
               " FROM task AS t \n" + 
               " WHERE jsonb_exists(t.worker_ids, :workerId)\n" + 
               " ORDER BY t.created_at\n", nativeQuery = true)
Optional<String> findMatchingTaskId(@Param("workerId") String workerId);

jsonb_exists的逻辑很直观：第一个参数传jsonb字段，第二个传要检查的字符串，返回布尔值表示该字符串是否存在于jsonb数组（或对象的键）中。

方案2：用ASCII码绕过转义问题 #

如果一定要保留运算符语法，可以用CHR(63)替代?（63是问号的ASCII编码），这样Spring Data就不会把它误判为参数占位符：

@Query(value = "SELECT t.id \n" + 
               " FROM task AS t \n" + 
               " WHERE (t.worker_ids CHR(63) :workerId)\n" + 
               " ORDER BY t.created_at\n", nativeQuery = true)
Optional<String> findMatchingTaskId(@Param("workerId") String workerId);

方案3：数组转换+ANY语法（仅适用于jsonb数组场景） #

如果你的worker_ids是纯jsonb数组（比如["worker_001", "worker_002"]），还可以把它转成text数组，用ANY语法判断元素是否存在：

@Query(value = "SELECT t.id \n" + 
               " FROM task AS t \n" + 
               " WHERE :workerId = ANY(t.worker_ids::text[])\n" + 
               " ORDER BY t.created_at\n", nativeQuery = true)
Optional<String> findMatchingTaskId(@Param("workerId") String workerId);

注意：这个方法只适合确定字段是纯数组的场景，否则会出现类型转换错误。

为什么原转义方式会失效？ #

Spring Data JPA在处理原生查询时，会先对SQL做预处理扫描所有?来绑定参数，这个扫描逻辑不会区分是否是转义后的问号。所以你写的\\?，最终可能还是被框架错误解析成参数占位符，导致参数数量不匹配的异常。

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