Hibernate查询LIKE子句含空格前缀精准匹配问题

嘿，这个问题我之前也踩过坑！核心需求就是要严格匹配包含空格的PRODUCT_ID完整值，而不是前缀匹配，之前没成功大概率是参数处理或者查询逻辑的小细节没到位，我给你几个可行的方案：

1. 直接用精确匹配（优先推荐） #

如果你明确要匹配的是完整的PRODUCT_ID（包括空格），别再用LIKE前缀匹配了，直接用等于号=做精确匹配最稳妥：

HQL写法： #

SELECT p FROM Product p WHERE p.productId = :targetProductId

参数设置： #

一定要确保你传入的参数完全包含目标ID的空格，比如数据库里的真实值是ABC1 （末尾带空格），那设置参数时就得传入带空格的字符串：

Query<Product> query = session.createQuery(hql, Product.class);
query.setParameter("targetProductId", "ABC1 "); // 注意这里的空格
List<Product> results = query.list();

这种写法只会返回和参数完全一致的记录，不会出现前缀匹配多返回结果的情况。

2. 用LIKE实现精确匹配（适用于必须用LIKE的场景） #

如果因为业务限制必须用LIKE，那可以直接匹配完整字符串，不要加通配符：

HQL写法： #

SELECT p FROM Product p WHERE p.productId LIKE :targetProductId

参数设置： #

同样要传入带空格的完整ID，比如"ABC1 "——当LIKE不带通配符时，效果就等同于=，会严格匹配整个字符串（包括空格）。

3. 排查数据库排序规则的隐形坑 #

如果上面两种方法还是没结果，很大概率是数据库的排序规则忽略了空格！比如MySQL的utf8mb4_general_ci这类排序规则，会把ABC1和ABC1 视为相等，反过来也会导致精确匹配失败。

解决办法有两个：

• 修改列的排序规则：把PRODUCT_ID列的collation改成区分空格的类型，比如utf8mb4_bin（二进制排序，严格区分所有字符）。
• 查询时强制指定排序规则：在HQL里用数据库特定函数强制区分空格，比如MySQL的写法：

SELECT p FROM Product p WHERE p.productId COLLATE utf8mb4_bin = :targetProductId

4. 验证实际执行的SQL #

最后可以开启Hibernate的SQL日志，确认实际执行的语句和参数值是否符合预期。比如在application.properties中添加：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

这样就能在控制台看到打印的SQL，检查参数是不是你预期的带空格的字符串。

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