Firebird 2.5+Hibernate 6.x：Dialect生成不支持的CONCAT语法求助

问题背景 #

使用Firebird 2.5搭配Hibernate 6.2/6.5时，调用带LIKE参数的自定义Repository方法，Hibernate会生成Firebird 2.5不支持的CONCAT函数，导致SQL执行报错。

可行解决办法 #

1. 修改原生查询语句，手动使用Firebird支持的拼接符 #

直接在自定义@Query中用Firebird的字符串拼接运算符||替代%:norm%的写法，避免Hibernate自动转换为CONCAT：

@Query(
      value = "select distinct t_m_gatunki.gatunek, .... where norm_symbol like '%' || :norm || '%'",
      nativeQuery = true
 )
Page<MaterialBrand> findByNormQuery(@Param("norm") String norm, Pageable pageable);

这种方式直接绕过Hibernate的参数处理逻辑，生成的SQL会直接使用||拼接，符合Firebird 2.5的语法要求。

2. 自定义Firebird方言，替换CONCAT函数实现 #

继承Hibernate的FirebirdDialect，重写字符串拼接函数的注册逻辑，让Hibernate生成||而非CONCAT：

public class CustomFirebird25Dialect extends FirebirdDialect {
    public CustomFirebird25Dialect() {
        super();
        // 注册自定义的concat函数，用||拼接参数
        registerFunction("concat", new SQLFunctionTemplate(StandardBasicTypes.STRING, "?1 || ?2 || ?3"));
        // 若需要支持更多参数的concat，可扩展为动态拼接：
        // registerFunction("concat", new VarArgsSQLFunction(StandardBasicTypes.STRING, "", " || ", ""));
    }
}

然后在配置文件中指定使用自定义方言：

# Spring Boot配置示例
spring.jpa.properties.hibernate.dialect=com.yourpackage.CustomFirebird25Dialect

这种方式从底层适配Firebird 2.5的语法，所有涉及CONCAT的查询都会自动转为||拼接，无需逐个修改查询语句。

补充说明 #

Firebird 2.5仅支持通过||进行字符串拼接，而Hibernate 6.x默认的Firebird方言是针对Firebird 3.0及以上版本（该版本已支持CONCAT函数），因此会出现语法兼容问题。通过上述两种方法可以快速解决该报错。

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