如何配置Hibernate让MaxDB与SQL Server统一处理带[]的LIKE查询

Hibernate 不会自动转义JPQL里LIKE语句的方括号，本质是两个原因：

• JPQL 规范仅定义了%（匹配任意长度任意字符）、_（匹配单个任意字符）两个标准LIKE通配符，没有对各数据库厂商自定义的扩展通配符做统一约定。SQL Server里的[]（字符范围匹配）、^（范围取反）都属于数据库私有语法，不属于JPA标准覆盖的范围。
• Hibernate 无法静态判断你写在LIKE模式里的[bar]是要作为普通字符串匹配，还是主动要使用SQL Server的范围匹配能力。如果默认全局转义所有方括号，会直接破坏那些确实需要用[a-z]这类语法做范围匹配的合法查询，作为通用ORM框架不会默认做这种有侵入性的隐式处理。

你遇到的跨库行为差异本质是数据库本身的LIKE实现不一致：MaxDB没有支持方括号通配符的扩展语法，所以方括号会直接作为普通字符匹配，刚好符合你的预期；但SQL Server会把未转义的方括号解析为通配符标记，导致查询结果不符合要求。

你不需要在Java代码里判断数据库类型手动转义，有三种成熟的Hibernate原生方案可以解决这个问题：

方案1：使用JPQL标准ESCAPE子句（最推荐，零自定义配置） #

JPQL原生支持为LIKE语句指定自定义转义字符，Hibernate会根据当前使用的方言，自动把转义逻辑翻译成对应数据库的合法语法，完全屏蔽数据库差异。你只需要在原有语句基础上稍作修改，给要作为普通字符的方括号前加上转义符，再声明转义字符即可：

SELECT someField FROM someEntity WHERE otherField LIKE '%foo![bar]' ESCAPE '!'

上述语句在SQL Server中会被Hibernate自动翻译成符合SQL Server语法的转义逻辑，在MaxDB中也会正常识别转义符匹配字面量，不需要任何额外配置，也不需要业务层判断数据库类型。

方案2：自定义SQL Server方言全局自动转义（完全不需要修改现有JPQL） #

如果你不想改动任何已写好的JPQL语句，可以自定义一个继承自SQLServer2012Dialect的方言类，重写LIKE转义逻辑，全局处理SQL Server私有的通配符：

public class AutoEscapeSQLServerDialect extends SQLServer2012Dialect {
    @Override
    public String escapeLike(String pattern, char escapeChar) {
        // 先执行父类默认的标准通配符(%、_)转义
        String baseEscaped = super.escapeLike(pattern, escapeChar);
        // 额外转义SQL Server私有的LIKE特殊字符
        return baseEscaped
                .replace("[", String.valueOf(escapeChar) + "[")
                .replace("]", String.valueOf(escapeChar) + "]")
                .replace("^", String.valueOf(escapeChar) + "^");
    }
}

之后把Hibernate配置里的hibernate.dialect参数替换为你这个自定义类的全限定名，原有JPQL不需要做任何修改，就能自动转义方括号，在SQL Server下返回正确结果。

方案3：规避LIKE语法，用字符串函数做后缀匹配 #

如果你的需求仅仅是匹配字段以固定字符串结尾，完全可以不使用LIKE，从根源上规避通配符解析差异：

• Hibernate 6及以上版本可以直接使用标准的ENDSWITH函数，写法最简洁：

  SELECT someField FROM someEntity WHERE ENDSWITH(otherField, 'foo[bar]')
  

• 低版本Hibernate可以用SUBSTRING+LENGTH函数实现相同逻辑，所有支持JPQL的数据库都能兼容：

  SELECT someField FROM someEntity WHERE SUBSTRING(otherField, LENGTH(otherField) - 7) = 'foo[bar]'
  

不存在可以一键开启的Hibernate全局“自动全字符转义”配置——核心原因还是之前提到的，框架无法区分你写的特殊字符是要做字面量还是要做通配符，所有自动转义逻辑都需要明确的规则边界，要么你通过ESCAPE子句显式标记转义位置，要么你通过自定义方言明确告诉框架哪些字符需要全局转义。

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