本文介绍如何使用 querydsl 的 booleanbuilder 构建包含多个 like 子句的动态查询谓词，实现对 postgresql 字符串字段（如 address）匹配任意给定关键词列表（如 ["foo", "bar", "baz"]）的模糊搜索。
本文介绍如何使用 querydsl 的 booleanbuilder 构建包含多个 like 子句的动态查询谓词，实现对 postgresql 字符串字段（如 address）匹配任意给定关键词列表（如 ["foo", "bar", "baz"]）的模糊搜索。
在 QueryDSL 中，LIKE 模糊匹配不能直接通过 eqAny()（该方法仅适用于精确数组匹配，如 PostgreSQL 的 = ANY(ARRAY[...]) 语法）实现，因为 LIKE 是模式匹配操作，需为每个关键词单独构造 like("%keyword%") 条件，并以逻辑 OR 组合。
正确做法是遍历关键词列表，逐个调用 StringPath.like() 方法，并通过 BooleanBuilder.or() 累加条件。示例如下：
final BooleanBuilder builder = new BooleanBuilder();
List<String> keywords = accountAddress.getAddressLine(); // e.g., ["foo", "bar", "baz"]
for (String keyword : keywords) {
if (keyword != null && !keyword.trim().isEmpty()) {
builder.or(qAccount.accAddress.like("%" + keyword.trim() + "%"));
}
}
Predicate predicate = builder.getValue();⚠️ 注意事项：
-
SQL 注入防护：若关键词来自用户输入，务必先进行转义（QueryDSL 提供
like("%" + escape(keyword) + "%", '\')配合自定义转义符），或更推荐使用参数化方式（如like("%" + keyword + "%").escape('\')并在数据库层统一配置转义符）； -
空值/空白处理：循环中应跳过 null 或空白字符串，避免生成无效或危险的
like("%%")条件； -
性能提示：
LIKE '%keyword%'无法利用 B-tree 索引前缀加速，如需高频模糊搜索，建议配合 PostgreSQL 的pg_trgm扩展 +GIN索引，或改用全文检索（to_tsvector/@@）； -
替代简洁写法（Java 8+）：可使用 Stream 减少样板代码：
Predicate predicate = accountAddress.getAddressLine().stream() .filter(Objects::nonNull) .map(k -> qAccount.accAddress.like("%" + k.trim() + "%")) .reduce(BooleanBuilder::or) .map(BooleanBuilder::getValue) .orElse(null);
最终生成的 SQL 将形如：
WHERE acc_address LIKE '%foo%' OR acc_address LIKE '%bar%' OR acc_address LIKE '%baz%'
该方案兼容 QueryDSL JPA（JPAQuery）与 QueryDSL SQL 模块，是实现“字段包含任一关键词”语义的标准、安全且可读性强的实践方式。
