Spring JpaRepository不识别@Column注解配置的表字段问题咨询

安全阿岳

2026-9-27

问题原因

核心原因是Spring Boot集成Hibernate时的默认命名策略自动转换了字段名：Spring Boot 2.x及后续版本默认使用SpringPhysicalNamingStrategy，该策略会将实体属性、@Column注解指定的字段名统一转换为下划线分隔的小写蛇形命名，因此你指定的campusId会被自动转换为campus_id，和数据库实际字段名不匹配。
次要原因可能为PostgreSQL标识符大小写规则问题：PostgreSQL对未加双引号的SQL标识符会自动转为小写存储，如果你建表时字段名campusId没有用双引号包裹，实际数据库中存储的字段名为campusid，也会导致匹配失败。
特殊情况：若@Column注解导入包错误（误导入org.hibernate.annotations.Column而非javax.persistence/jakarta.persistence下的Column注解），会导致指定的字段名不生效。

解决方案

你可以根据实际场景选择以下任意一种方案：

方案一：修改全局命名策略（适配现有驼峰字段名）
在application.yml或application.properties中添加如下配置，让Hibernate严格按照@Column指定的名称生成SQL，不做自动转换：

# yml配置示例
spring:
  jpa:
    hibernate:
      naming:
        physical-strategy: org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
        implicit-strategy: org.hibernate.boot.model.naming.ImplicitNamingStrategyLegacyJpaImpl

# properties配置示例
spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
spring.jpa.hibernate.naming.implicit-strategy=org.hibernate.boot.model.naming.ImplicitNamingStrategyLegacyJpaImpl

方案二：单独适配字段名（不想改全局配置时使用）
如果数据库实际字段名是驼峰格式campusId，可以修改@Column注解，给字段名加上双引号强制PostgreSQL识别驼峰命名：

@Column(name = "\"campusId\"")
private String campusId;

如果数据库实际字段名是小写campusid，直接修改@Column的name值即可：

@Column(name = "campusid")
private String campusId;

方案三：修改数据库字段（符合业界通用规范）
将数据库表中campusId字段重命名为下划线格式campus_id，同时其他驼峰字段也同步改为蛇形命名（比如metric_id、dept_code等），适配Hibernate默认命名策略，符合关系型数据库字段命名的通用规范。

内容的提问来源于stack exchange，提问作者Kalio O'Farril