Spring Boot JPA连接MSSQL报错：逻辑列对应多物理列

问题原因 #

报错提示Table [promcomparison] contains logical column name [hipExtrSd] referring to multiple physical column names: [hip_extrsd], [hip_extr_sd]，核心原因是JPA默认会将驼峰命名的实体字段转换为下划线分隔的物理列名，而数据库中存在hip_extrsd和hip_extr_sd两个相似列，导致JPA无法确定字段对应的目标列，引发映射歧义。

解决方案 #

1. 清理数据库冗余列 #

先检查MSSQL中PROMComparison表的结构，确认hip_extrsd和hip_extr_sd哪个是业务需要的有效列，删除多余的冗余列，从根源消除映射冲突。

2. 明确指定物理列名 #

在实体类的@Column注解中直接指定数据库实际存在的物理列名，跳过JPA的自动转换逻辑，消除歧义。修改后的实体类示例：

@Getter
@Setter
@Data
@NoArgsConstructor
@Entity
@Table(name = "PROMComparison")
public class IPromComparison {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "promCompId")
    private Integer promCompId;
    
    // 根据数据库实际列名修改name属性，例如对应hip_extr_sd
    @Column(name = "hip_extr_sd")
    private String hipExtrSd;
}

3. 统一JPA命名策略 #

如果项目需要全局统一映射规则，可在配置文件中指定明确的命名策略，确保实体字段到数据库列名的转换唯一：

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

若数据库列统一使用下划线分隔命名，也可使用Spring策略自动转换驼峰为下划线：

spring.jpa.hibernate.naming.physical-strategy=org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy

注意：使用该策略时必须确保数据库中每个实体字段仅对应唯一的下划线格式列，避免出现类似hip_extrsd和hip_extr_sd的重复列。

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