本文揭示 Spring Boot 中 JPA 查询（含原生 SQL）持续返回 null 的典型陷阱：当数据库表在 Repository 定义前已被创建，JPA 无法正确映射字段或执行查询，导致看似正确的代码始终获取空值。
本文揭示 spring boot 中 jpa 查询（含原生 sql）持续返回 `null` 的典型陷阱：当数据库表在 repository 定义前已被创建，jpa 无法正确映射字段或执行查询，导致看似正确的代码始终获取空值。
在 Spring Boot + JPA 开发中，adminRepo.getp(login) 持续返回 null，而直接在数据库中执行相同 SQL 却能查到数据——这种“代码无误、结果异常”的现象，往往并非逻辑错误，而是JPA 实体与数据库表之间的元数据同步被破坏所致。
核心问题在于：表结构的创建时机早于 Repository 接口的定义。
Spring Boot 默认启用 spring.jpa.hibernate.ddl-auto=auto（或 create, update 等），其建表行为高度依赖 @Entity 类的完整元信息（如字段名、类型、列映射、大小写敏感性等）。但若仅凭 Admin 实体首次启动应用，Hibernate 会按 Java 字段名（如 Password）生成数据库列（如 password 或 PASSWORD，取决于方言和命名策略），而后续添加的 @Query(... nativeQuery = true) 却试图从一个 未被 JPA 元模型识别 的列中取值——此时即使列物理存在，JPA 也可能因元数据缺失或不一致拒绝映射，最终返回 null。
更关键的是：你使用的原生查询 SELECT Password FROM Admin WHERE login = :login 存在两个隐蔽风险点：
- 列名大小写不匹配：Java 字段 Password（首字母大写）在多数数据库（如 MySQL 默认配置、H2）中会被映射为小写列名 password；而原生 SQL 中显式写 Password 可能因数据库区分大小写导致查不到（尤其 PostgreSQL 或启用了 lower_case_table_names=0 的 MySQL）；
- JPA 不管理原生查询的字段映射：nativeQuery = true 绕过 JPA 实体映射，完全依赖数据库实际列名。若建表时 Hibernate 生成的是 password，而查询写 Password，则结果为空。
✅ 正确做法如下：
第一步：确保建表由 JPA 全权驱动
删除现有表，清空数据库，并在 application.properties 中明确配置：
spring.jpa.hibernate.ddl-auto=update spring.jpa.show-sql=true spring.jpa.properties.hibernate.format_sql=true
⚠️ 注意：生产环境应禁用 ddl-auto，此处仅用于开发排障。
第二步：修正实体字段命名规范（强烈推荐）
避免使用驼峰大写开头字段（如 Password），改用全小写加下划线命名，并显式指定列名：
@Entity
public class Admin {
@Id
private String login;
@Column(name = "password") // 显式声明列名，消除歧义
private String password; // 字段名改为小写
// getter/setter（注意：getter 必须是 getPassword()，符合 JavaBean 规范）
public String getPassword() { return password; }
public void setPassword(String password) { this.password = password; }
}
第三步：重写原生查询，使用标准列名
@Repository
public interface AdminRepository extends JpaRepository<admin string> {
@Query(value = "SELECT password FROM admin WHERE login = :login", nativeQuery = true)
String getPasswordByLogin(@Param("login") String login);
}</admin>
✅ 提示：表名 admin 使用小写（符合多数数据库默认行为）；列名 password 与 @Column(name = "password") 严格一致。
第四步：验证与调试
启动应用后，观察日志中 Hibernate 输出的建表 SQL：
create table admin (login varchar(255) not null, password varchar(255), primary key (login))
确认列名确为 password，再执行查询即可获得预期结果。
? 总结：JPA 查询返回 null 的常见根源不是语法错误，而是元数据与物理结构的错位。务必遵循“先定义完整 Entity + Repository，再启动应用建表”的流程；对原生查询，坚持“列名显式声明 + 小写统一”原则；并通过 show-sql 日志验证实际执行语句，方能一劳永逸规避此类静默失败。
