QueryDSL结合JPARepository如何为AttributeConverter转的JSON列表字段编写Predicate

问题根因 #

你现在用@Convert把List<ProgramRegistration>转换成JSON字符串存储，JPA和QueryDSL只会将programRegistrations字段识别为普通字符串类型，而非JPA关联集合，因此没有对应的集合操作方法，也无法直接遍历访问嵌套的program字段，这是你原来的代码无法运行的根本原因。

解决方案1：使用数据库原生JSON函数（推荐，性能最优） #

主流数据库（MySQL、PostgreSQL等）都提供JSON操作函数，你可以通过QueryDSL的模板表达式直接调用数据库函数完成过滤，过滤逻辑在数据库层面执行，不影响分页效率。

MySQL 示例代码 #

用JSON_SEARCH函数匹配JSON数组内的program字段：

if (StringUtils.isNotBlank(programName)) {
    // 精确匹配直接传programName，模糊匹配可以加%包裹参数
    String matchValue = programName;
    builder.and(Expressions.stringTemplate(
        "JSON_SEARCH({0}, 'one', {1}, null, '$[*].program')",
        QTerminal.terminal.programRegistrations,
        matchValue
    ).isNotNull());
}

PostgreSQL 示例代码 #

用JSONB包含操作符匹配：

if (StringUtils.isNotBlank(programName)) {
    String matchJson = String.format("[{\"program\": \"%s\"}]", programName);
    builder.and(Expressions.booleanTemplate(
        "{0}::jsonb @> {1}::jsonb",
        QTerminal.terminal.programRegistrations,
        matchJson
    ).isTrue());
}

解决方案2：调整实体结构为JPA标准集合（兼容性最优） #

如果可以修改表结构，建议将ProgramRegistration改为@Embeddable，用@ElementCollection存储为独立关联表，这样JPA和QueryDSL可以直接识别集合结构，原生支持any()操作：

1. 调整ProgramRegistration注解：

@Data
@Embeddable // 新增可嵌入注解
public static class ProgramRegistration {
    private String program;
    private boolean online;
}

2. 修改Terminal的字段注解：

@ElementCollection
private List<ProgramRegistration> programRegistrations;

调整后你原来写的QTerminal.terminal.programRegistrations.any().program.contains(...)代码就可以直接运行，不需要依赖数据库JSON特性，完全符合JPA规范。

解决方案3：内存过滤（仅适合小数据量场景） #

如果不能改表结构也不想用数据库特定函数，可以先查询出所有符合其他条件的Terminal，再在内存中过滤programRegistrations，但该方案会导致分页不准，数据量大时性能极低：

Page<Terminal> originPage = terminalRepository.findAll(builder.getValue(), p);
List<Terminal> filteredList = originPage.getContent().stream()
    .filter(terminal -> terminal.getProgramRegistrations().stream()
        .anyMatch(reg -> reg.getProgram().contains(programName))
    )
    .collect(Collectors.toList());
return new PageImpl<>(filteredList, p, filteredList.size());

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