Spring Boot映射SQL Server列报错：未定义emp_code却提示列名无效

问题描述 #

数据库表列名为empCode，Spring Boot实体类映射配置如下：

@Column(name="empCode")
String empCode;

调用Rest接口查询时：

@GetMapping("/employee")
public List<Employee> findAll() {
    return employeeService.findAll();
}

抛出错误：

Caused by: com.microsoft.sqlserver.jdbc.SQLServerException: Invalid column name 'emp_code'.

因多机构共用数据库无法修改列名，需解决该问题。

原因分析 #

核心问题出在Hibernate（Spring Boot默认JPA实现）的物理命名策略：默认情况下，Hibernate会自动把实体类的驼峰命名字段（如empCode）转换为下划线分隔的数据库列名（emp_code），但数据库实际列名是empCode，因此触发列名不存在的错误。

解决办法 #

方案1：全局配置禁用驼峰转下划线 #

在application.properties或application.yml中添加配置，指定Hibernate使用保持原字段名的物理命名策略：

# application.properties
spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl

或yaml格式：

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

该配置会让Hibernate严格按照实体类@Column注解指定的列名生成SQL，不再自动转换驼峰格式。

方案2：确保字段映射的大小写精准匹配 #

如果SQL Server开启了大小写敏感设置，需保证@Column的name属性大小写完全匹配数据库列名，可补充columnDefinition明确列信息，避免解析偏差：

@Column(name = "empCode", columnDefinition = "NVARCHAR(50)")
private String empCode;

方案3：排查自定义命名策略 #

检查项目中是否存在自定义的Hibernate命名策略Bean，或引入的第三方配置类覆盖了默认规则，如有则调整配置，使其不对empCode这类字段进行格式转换。

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