如何在JPA Specification中对UUID字段使用LIKE运算符进行模糊查询

失效原因 #

你的代码无法生效是两个核心问题导致：

1. 数据库原生UUID类型字段无法直接参与字符串LIKE运算，你之前调用.as(String.class)仅为JPA表达式层面的类型标记，不会生成数据库层面的强转SQL，因此无法完成类型匹配。
2. 你仅对数据库字段做了大写转换，拼接的查询值没有同步转大写，大小写不统一也会导致匹配失败。

可用实现代码 #

通过builder.function调用数据库标准类型转换函数，将UUID强转为字符串后再执行LIKE运算：

private static final String LIKE = "%";

public static Specification<MyEntity> keyLike(final UUID key) {
    if (key == null) {
        return (root, query, builder) -> builder.and();
    }
    // 标准SQL CAST转换，兼容大多数支持UUID类型的数据库
    Expression<String> uuidToStr = builder.function(
        "CAST",
        String.class,
        root.get(MyEntity_.KEY),
        builder.literal(String.class)
    );
    // 可根据数据库类型替换转换函数，性能更优：
    // PostgreSQL替换为：builder.function("TEXT", String.class, root.get(MyEntity_.KEY))
    // MySQL替换为：builder.function("CHAR", String.class, root.get(MyEntity_.KEY))
    return (root, query, builder) -> builder.like(
        builder.upper(uuidToStr),
        LIKE + key.toString().toUpperCase() + LIKE
    );
}

注意事项 #

• 若你的MySQL库中UUID以binary(16)无横线格式存储，需要先将传入的UUID参数转为对应的无横线格式后再拼接匹配符
• 若对查询性能要求较高，建议新增一个冗余的UUID字符串字段并建索引，避免全表扫描
• Hibernate实现下也可通过@Type注解将实体UUID字段直接映射为字符串类型存储，无需转换即可直接调用LIKE运算

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