Spring JpaRepository中如何转义PostgreSQL jsonb操作符的问号？

这个问题我之前也碰到过，Hibernate的参数解析逻辑会把查询里的?默认当成参数占位符，常规的转义方式确实不管用。这里给你几个实用的解决方案：

方案一：用PostgreSQL内置函数替代?|操作符 #

其实PostgreSQL的?|操作符是jsonb_exists_any(jsonb, text[])函数的语法糖，直接调用这个函数就能避开问号的冲突。修改你的查询语句如下：

@Query(value = "SELECT * FROM public.user u WHERE jsonb_exists_any(u.authorities, array['ROLE_1', 'ROLE_2'])", nativeQuery = true)
List<User> findUsersWithMatchingAuthorities();

这种方式最直接，不需要额外配置，Hibernate不会把函数里的内容当成参数占位符，查询可以正常执行。

方案二：修改Hibernate参数占位符前缀（谨慎使用） #

你可以通过配置把Hibernate的参数占位符从?改成其他字符（比如:），这样原来的?就不会被解析成参数了。不过这个方法需要统一调整所有查询的参数写法，可能会影响现有代码，所以要谨慎。

在application.properties里添加配置：

spring.jpa.properties.hibernate.query.param_prefix = :

之后你的查询可以保留?|操作符，但参数要改用:前缀（如果有动态参数的话）：

@Query(value = "SELECT * FROM public.user u WHERE u.authorities ?| array[:role1, :role2]", nativeQuery = true)
List<User> findUsersWithAuthorities(@Param("role1") String role1, @Param("role2") String role2);

方案三：自定义Hibernate方言（进阶方案） #

如果坚持要用?|的语法，可以自定义Hibernate方言来调整参数解析逻辑。不过这个方法相对复杂，适合有一定Hibernate基础的开发者：

1. 编写自定义方言类，注册对应的jsonb函数：

public class CustomPostgreSQLDialect extends PostgreSQL95Dialect {
    public CustomPostgreSQLDialect() {
        super();
        registerFunction("jsonb_exists_any", new StandardSQLFunction("jsonb_exists_any", StandardBasicTypes.BOOLEAN));
    }
}

2. 在配置中指定这个方言：

spring.jpa.properties.hibernate.dialect = com.yourpackage.CustomPostgreSQLDialect

不过还是优先推荐方案一，简单高效，完全不需要额外配置就能解决问题。

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