Spring Boot中Hibernate命名策略引发“Unknown column”错误的解决咨询

问题分析 #

你遇到的问题是Hibernate默认命名策略会自动将实体类的驼峰式字段名转换为下划线分隔的数据库列名，即便通过@Column(name = "ProductId")指定了列名，全局命名策略也可能覆盖该配置，导致Hibernate生成的SQL中使用product_id而非数据库实际存在的ProductId列。

解决方案 #

1. 全局配置命名策略（推荐）

根据你的Spring Boot版本，在配置文件中设置对应Hibernate命名策略，让字段名直接映射数据库列名，不做自动转换：

Spring Boot 2.x 及以上版本

在application.properties中添加：

# 使用标准物理命名策略，严格遵循@Column指定的名称或字段名
spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl

如果使用application.yml：

spring:
  jpa:
    hibernate:
      naming:
        physical-strategy: org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl

该策略会直接使用你在@Column中指定的列名，或实体类字段名作为数据库列名，不会进行驼峰转下划线的转换。

Spring Boot 1.x 版本

若使用旧版本Spring Boot，配置如下：

spring.jpa.hibernate.naming.strategy=org.hibernate.cfg.EJB3NamingStrategy

2. 字段级别的确认

若全局配置后仍有问题，检查实体类注解是否准确：

@Entity
@Table(name = "product")
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class Product {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    // 确保name属性完全匹配数据库列名，可添加nullable明确约束
    @Column(name = "ProductId", nullable = false)
    private Integer id; // 建议用Integer替代int，避免主键为空时的类型问题
    // Other fields...
}

3. 验证配置

重启应用后，开启Hibernate SQL日志（添加spring.jpa.show-sql=true到配置文件），查看生成的SQL语句，确认列名已正确使用ProductId而非product_id。

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