Spring Boot 2中JpaRepository查询未区分大小写问题求助

首先咱们先搞清楚问题根源：你的查询默认不区分大小写，大概率是**MySQL数据库的字符集排序规则（Collation）**在起作用。MySQL默认的排序规则比如utf8mb4_general_ci或者utf8mb4_0900_ai_ci里的ci就是「Case Insensitive（大小写不敏感）」的意思，所以哪怕你在JPA里没加IgnoreCase注解，数据库层面还是会忽略大小写进行匹配。

接下来给你几个可行的解决方案，以及怎么打印实际执行的SQL来排查问题：

一、从数据库层面彻底解决（推荐长期方案） #

如果你的业务确实需要严格区分大小写查询，最好从数据库层面调整：

1. 先检查当前列的排序规则：
   执行以下SQL语句查看name列的配置：

   SHOW FULL COLUMNS FROM player LIKE 'name';
   

   看结果里的Collation字段，如果值带ci，就说明是大小写不敏感的规则。

2. 修改列的排序规则为区分大小写：
   可以改成utf8mb4_bin（二进制严格匹配，区分大小写和重音）或者utf8mb4_0900_as_cs（MySQL 8.0+支持，专门的大小写敏感规则）：

   ALTER TABLE player MODIFY COLUMN name VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
   

   修改完成后，原来的findByName(name)方法就会自动严格区分大小写了。

二、在JPA查询中显式指定区分大小写（无需改动数据库） #

如果暂时不想调整数据库，可以通过自定义查询强制实现大小写敏感匹配：

方式1：使用JPQL自定义查询 #

在你的PlayerRepository中新增方法：

@Query("SELECT p FROM Player p WHERE FUNCTION('BINARY', p.name) = :name")
Optional<Player> findByNameCaseSensitive(@Param("name") String name);

这里的FUNCTION('BINARY', ...)会调用MySQL的BINARY函数，把字段值转换成二进制进行严格的大小写匹配。

方式2：使用原生SQL查询 #

同样在Repository中定义方法：

@Query(value = "SELECT * FROM player WHERE BINARY name = :name", nativeQuery = true)
Optional<Player> findByNameCaseSensitive(@Param("name") String name);

三、如何查看JPA执行的实际SQL #

要确认JPA到底执行了什么SQL语句，只需要在application.properties（或application.yml）中添加以下配置：

# 显示执行的SQL语句
spring.jpa.show-sql=true
# 格式化SQL，方便阅读
spring.jpa.properties.hibernate.format_sql=true

重启项目后，控制台就会输出格式化后的SQL，你能直观看到查询条件是否做了大小写处理。

最后补充说明：你提到数据库允许保存大小写不同的同名记录，这是因为你的主键不是name字段，所以MySQL允许插入；但查询时因为排序规则的特性，会把大小写不同的值视为匹配，才会出现「传入peter却查到Peter」的情况。

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