Spring Data CrudRepository按用户名查询始终返回0条结果求助

• Entity字段映射不匹配
  检查Customer实体类的username字段与数据库表字段的映射是否正确：

  • PostgreSQL默认字段名是小写格式（如username），若实体类使用了驼峰命名且未配置自动转换，或@Column注解指定的name属性与数据库字段名不一致，会导致映射失败。
  • 示例错误：

    @Column(name = "user_name") // 数据库实际字段为username
    private String username;
    

  • 可通过开启Spring Boot驼峰转下划线配置解决：spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.CamelCaseToUnderscoresNamingStrategy

• 查询大小写不匹配
  PostgreSQL默认对字符串查询大小写敏感，若数据库中存储的username为admin，但请求传入的是Admin，会直接返回空结果。可通过以下方式处理：

  • 确保Postman请求参数与数据库数据大小写完全一致
  • 使用Spring Data提供的findByUsernameIgnoreCase方法实现忽略大小写查询

• Repository方法命名错误
  确认Repository接口中的方法名严格遵循Spring Data规范：方法名需为findByUsername（字段名首字母大写），若实体类字段为userName，则方法名应为findByUserName，否则无法生成正确的查询SQL。

• 数据或事务问题

  • 直接用psql客户端查询数据库，确认目标username数据确实存在且已提交（避免数据在未提交事务中无法被查询）
  • 检查Service层方法是否正确处理事务，确保查询操作在有效事务上下文执行

• 查看生成的SQL语句
  开启SQL日志排查生成的查询语句是否正确，在application.properties中添加配置：

  spring.jpa.show-sql=true
  spring.jpa.properties.hibernate.format_sql=true
  

  运行查询后，查看控制台输出的SQL，确认WHERE条件、传入参数是否与预期一致。

• 参数传递错误
  在CustomerService第18行附近添加日志，输出传入的username参数值，确认参数未被修改、未传入null或空字符串。

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