HQL用双参数LTRIM DB2运行正常 内存库报SQLSyntaxErrorException异常

你遇到的报错是不同数据库的LTRIM函数语法不兼容导致的：

• DB2的LTRIM函数支持双参数语法：LTRIM(字符串, 要裁剪的字符集)，可以自定义裁剪前缀字符
• 测试用的内存数据库（大概率是H2/HSQLDB/Derby这类常用测试库）的原生LTRIM仅支持单参数：LTRIM(字符串)，只能裁剪开头的空格，不支持第二个参数指定裁剪字符，所以解析SQL时遇到逗号就直接抛语法错误。

方案1：改用HQL标准裁剪函数（推荐，跨库兼容） #

Hibernate 5.3及以上版本提供了标准的TRIM规范语法，支持指定要裁剪的字符和裁剪方向，Hibernate会自动根据底层数据库适配SQL语法：

from ABean s where s.cId in (
    select ca.id from CBean ca 
    where TRIM(LEADING '0' FROM ca.refNumber) = TRIM(LEADING '0' FROM '$ref$') 
    and ca.valid = 0
)

这个写法在DB2和主流内存数据库都能正常运行，不需要额外配置。

方案2：自定义数据库函数方言 #

如果你的Hibernate版本较低不支持上述标准TRIM语法，可以给测试用的内存数据库注册自定义LTRIM双参数函数，比如用H2的话，在测试配置的数据库连接初始化脚本里加：

CREATE ALIAS LTRIM FOR "org.apache.commons.lang3.StringUtils.stripStart";

也可以在Hibernate方言类里注册函数的映射规则，让Hibernate把双参数LTRIM自动转成内存数据库支持的写法。

方案3：对齐生产环境数据库做测试 #

如果不想改业务代码，可以用Testcontainers启动一个真实的DB2容器做单元测试，完全避免数据库语法差异问题。

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