SpringBoot项目中JpaRepository的findByEmail查询失效问题排查

你之前加@Query的写法完全不符合规范 #

你尝试加的@Query("SELECT * FROM user u WHERE u.email=:email")是原生SQL语法，Spring Data JPA默认按JPQL规则解析，会直接触发运行报错：

• JPQL不支持SELECT *，必须明确指定实体别名
• JPQL的FROM后必须跟实体类名，不能直接写数据库表名
• 要使用原生SQL查询必须显式声明nativeQuery = true，否则解析逻辑完全失效

正确写法参考：

// JPQL写法
@Query("SELECT u FROM User u WHERE u.email = :email")
User findByEmail(@Param("email") String email);

// 原生SQL写法（注意给保留字加反引号）
@Query(value = "SELECT * FROM `user` u WHERE u.email = :email", nativeQuery = true)
User findByEmail(@Param("email") String email);

保留字冲突导致的查询解析异常 #

你给User实体没有显式指定表名，JPA默认会将实体类名user作为数据库表名，这是Hibernate和MySQL的内置保留关键字：

• 虽然findAll()能凑巧返回3条数据，但条件查询会因为表名歧义出现解析错误或匹配失效
• 修正方法：给User实体指定非保留字的自定义表名，从根源避免冲突

@Entity
@Table(name = "sys_user") // 替换为业务自定义的非关键字表名
public class User {
    // 原有字段定义保持不变
}

数据匹配的隐形差异 #

findAll()能稳定查到3条记录，说明Repository层的基础查询链路是通的，findByEmail返回null本质是查询条件和数据库存储的值完全不匹配：

• 检查初始化脚本（data.sql/导入的业务数据）里的邮箱字段，和测试用的"mail@mail.com"是否存在不可见差异：比如前后带空格、全角@符号、大小写不匹配（如果数据库字段配置了区分大小写的排序规则）
• 可以在测试方法里先遍历所有查到的用户，打印每个用户的email字段值，和测试入参逐字符比对
• 临时验证可以在测试方法里手动新增一条已知邮箱的用户，再调用查询方法，排除初始化数据的问题

配置项的执行顺序坑 #

你当前使用的spring.jpa.hibernate.ddl-auto=create-drop+spring.datasource.initialization-mode=always存在版本兼容问题：

• 旧版Spring Boot的默认执行顺序是先运行初始化SQL，再由Hibernate执行create-drop逻辑（删除旧表、新建空表），会导致你手动通过MySQL Workbench插入的数据被直接清空
• 你现在能通过list()查到3条数据，说明当前版本的执行顺序是正确的，但如果多次重启测试，可能出现旧表结构和新实体映射不匹配的问题
• 开启SQL日志打印，直接对照实际执行的查询语句和绑定参数，快速定位问题：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE

打印日志后可直接核对：实际执行的表名、列名是否正确，where条件绑定的email参数值是否和预期一致。

常见误区纠正 #

• 不要随意把findByEmail的返回值改成List<User>排查问题：当查询结果为0条时，List会返回空集合，反而会掩盖“条件不匹配”的核心问题
• 不要混淆手动在MySQL Workbench里查的数据和单元测试运行时的数据库数据：create-drop模式下每次启动测试都会重建表、清空旧数据，Workbench里手动插入的数据根本不会出现在测试运行的数据库会话中

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