Spring JPA按userName查询MySQL用户数据始终返回空列表求助

我来帮你一步步梳理这个问题，这种情况通常是几个常见原因导致的，咱们逐一排查：

1. 检查实体类与数据库字段的映射是否匹配 #

Spring JPA默认会把实体类的驼峰属性（比如userName）转换为下划线分隔的数据库字段（user_name）。如果你的MySQL表中对应的字段是username（没有下划线），那映射就会出错，导致查询不到数据。

解决方法：给实体类的userName属性添加@Column注解指定数据库字段名：

@Entity
@Table(name = "user")
public class User {
    // 其他属性...
    @Column(name = "username") // 替换成你数据库实际的字段名
    private String userName;
    // getter/setter...
}

2. 验证数据库数据与排序规则 #

即使你用了IgnoreCase，如果数据库的排序规则（collation）是区分大小写的（比如utf8_bin），这个查询也可能不生效。另外要确认数据库中确实存在对应用户名（不管大小写）的数据。

• 先手动在MySQL执行SQL验证：

  SELECT * FROM user WHERE LOWER(user_name) = LOWER('你的测试用户名');
  

  如果这条SQL也查不到结果，那说明数据库里确实没有对应数据；如果能查到，那就要修改表的排序规则为不区分大小写的类型（比如utf8_general_ci或utf8mb4_general_ci）。

3. 开启SQL日志查看实际执行的语句 #

启用JPA的SQL日志，能直观看到框架生成的SQL和绑定的参数，排查是不是参数传递错误或者SQL生成不符合预期。

在application.properties中添加日志配置：

logging.level.org.hibernate.SQL=DEBUG
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE

启动应用后，查看日志里的SQL语句，确认参数是否正确，查询条件是否和预期一致。

4. 检查DTO参数是否正确传递 #

看你代码里的日志语句logger.info("Login request for customer {} with password {}", loginDTO.getUserName(), loginDTO.getPassword());，先确认日志输出的用户名是不是你预期的值。如果这里显示的是null或者空字符串，那说明前端传递的参数没有正确绑定到LoginDTO的userName属性上，需要检查DTO的属性名和前端参数名是否一致（比如前端传的是username而DTO是userName，可以添加@JsonProperty("username")注解来映射）。

5. 确认数据已提交到数据库 #

如果是测试场景，要确保测试数据已经真正提交到MySQL中。比如如果用了@Transactional注解，默认测试结束会回滚，这时候数据库里看不到数据，查询自然返回空。可以在测试方法上添加@Rollback(false)或者手动提交事务。

先从上面这几个方向排查，应该能找到问题所在。

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