QueryDSL 4.2.1参数类型匹配异常问题求助

这个问题不是你的使用疏漏，而是QueryDSL 4.2.1版本中StringExpression.startsWith()方法在处理常量表达式在前、实体字段在后的场景时存在解析bug——3.7.4版本的逻辑能正确处理这种写法，但4.x版本的参数绑定逻辑发生了变化，导致了类型匹配错误和参数顺序颠倒。

为什么会抛出异常？ #

你反转参数的代码longName.startsWith(qTest.name)，本应生成的SQL是：

select test from TEST test where 'test01' like concat(test.name, '%')

但QueryDSL 4.2.1错误地将%作为第一个参数绑定，同时错误地期望这个参数是Boolean类型（内部表达式解析逻辑的错误），最终触发了IllegalArgumentException。

解决方案 #

有几种可行的解决方式：

1. 调整表达式顺序（推荐）

如果业务逻辑允许，尽量保持实体字段在前、常量在后的写法，这是QueryDSL设计的标准用法，能避免版本兼容问题：

query.where(qTest.name.startsWith(longName));

2. 手动构建LIKE表达式

如果必须保持常量在前的逻辑，可以直接使用like()方法配合concat()实现前缀匹配：

query.where(longName.like(qTest.name.concat("%")));

3. 使用字符串模板

通过Expressions.stringTemplate()手动定义SQL片段，确保参数绑定逻辑完全符合预期：

query.where(Expressions.stringTemplate("{0} like concat({1}, '%')", longName, qTest.name));

4. 升级QueryDSL版本

这个bug在QueryDSL 4.4.0及之后的版本中已经被修复，如果你可以升级依赖版本，直接升级到更高的稳定版（比如4.4.0或最新版），就能无需修改代码解决问题。

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