Spring Boot嵌套实体不区分大小写查询失效问题排查

你的问题可以从以下几个方向排查解决：

1. 数据库字段规则问题 #

部分数据库的字段排序规则默认区分大小写（比如MySQL的utf8_bin），或是字符集不支持正常的大小写转换。你可以先在数据库客户端执行原生SQL验证：

SELECT c.* FROM customer c 
JOIN company co ON c.company_id = co.id 
WHERE LOWER(co.company_name) LIKE '%abc%';

如果这条原生SQL也查不到结果，说明是数据库字段的问题：

• 修改字段排序规则为不区分大小写的类型（比如MySQL的utf8mb4_general_ci或utf8mb4_unicode_ci）；
• 或者改用数据库原生的不区分大小写匹配语法（比如PostgreSQL的ILIKE）。

2. JPA HQL解析嵌套属性异常 #

HQL对嵌套实体属性的LOWER函数解析可能出现预期外的情况，你可以开启JPA的SQL日志（比如Spring Boot中设置spring.jpa.show-sql=true），查看实际生成的SQL是否正确处理了c.company.companyName的大小写转换。如果生成的SQL有问题，建议改用Spring Data JPA的自动生成方法，无需手动编写HQL：

// 框架自动生成不区分大小写的包含查询
List<Customer> findByCompany_CompanyNameContainingIgnoreCase(String search);

这种方式由框架自动处理大小写转换和嵌套属性关联，可靠性更高。

3. 隐式字符干扰 #

检查数据库中companyName字段是否包含前后空格、全角空格或不可见字符，或是传入的search参数被意外转义。可以在代码中对参数做预处理：

String processedSearch = search.trim().toLowerCase();
List<Customer> result = customerRepository.findByCompanyNameContainingIgnoreCase(processedSearch);

同时直接查询数据库字段的实际值，确认没有隐藏字符干扰匹配。

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