PostgreSQL+Spring Data JPA大小写不敏感文本对比失效问题解决

首先先修正你现有代码里的明显问题：你的SQL语句末尾多了一个多余的右括号，这会导致语法错误，大概率是引发随机结果异常的原因，先把它去掉；另外返回类型List<Recipe>和查询的Employee不匹配，也建议一并修正。修正后的代码如下：

@Query(value = "SELECT DISTINCT e.id, e.name FROM Employee e " +
        "WHERE e.name ILIKE :name",
        nativeQuery = true)
List<Employee> getEmployees(@Param("name") String name);

接下来针对大小写不敏感的等值对比，推荐几种更可靠的实现方式：

1. 使用LOWER()函数做精确匹配 #

这是最通用的方案，把字段和参数都转成小写后做等值对比，避免ILIKE可能带来的模糊匹配歧义：

@Query(value = "SELECT DISTINCT e.id, e.name FROM Employee e " +
        "WHERE LOWER(e.name) = LOWER(:name)",
        nativeQuery = true)
List<Employee> getEmployees(@Param("name") String name);

如果需要优化查询性能，可以给LOWER(name)创建函数索引：

CREATE INDEX idx_employee_lower_name ON Employee (LOWER(name));

2. 使用PostgreSQL的citext类型 #

PostgreSQL提供了citext扩展类型，它会自动忽略大小写进行字符串对比，适合需要全局大小写不敏感的场景：

• 首先启用citext扩展：

CREATE EXTENSION IF NOT EXISTS citext;

• 修改Employee表的name字段类型为citext：

ALTER TABLE Employee ALTER COLUMN name TYPE citext;

• 之后直接用普通的=就能实现大小写不敏感的等值对比，代码更简洁：

@Query(value = "SELECT DISTINCT e.id, e.name FROM Employee e " +
        "WHERE e.name = :name",
        nativeQuery = true)
List<Employee> getEmployees(@Param("name") String name);

这种方式性能最优，因为可以直接使用普通的B-tree索引。

3. 保留ILIKE但确保精确匹配 #

如果你坚持用ILIKE，要明确是精确匹配，需要确保参数是完整的字符串（不要加%通配符），修正语法错误后的代码就能正常工作，但这种方式相比前两种，性能略差，且容易因为误加通配符导致模糊匹配。

关于你遇到的"Spring Boot中结果随机不一致但DBeaver正常"的问题，除了语法错误外，还可能是参数绑定的字符编码问题，建议检查Spring Boot的数据库连接配置，确保和DBeaver使用的字符编码一致（比如UTF-8），同时确认参数传递时没有被额外的大小写转换处理。

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