SpringBoot JPA项目启动报process_event表缺失event_id列错误如何解决

你遇到的报错是Hibernate命名策略默认转换字段命名格式导致的：

Schema-validation: missing column [event_id] in table [process_event]

报错信息显示Hibernate在查找名为event_id的列，但你在@Column注解中显式指定的列名是eventId，这是因为SpringBoot 2.x+默认使用SpringPhysicalNamingStrategy作为物理命名策略，该策略会自动将所有驼峰格式的标识符转换为下划线分隔的蛇形命名，即使你在@Column的name属性中指定了驼峰格式也会被转换，最终校验时和实际表结构不匹配抛出错误。

方案一：修改全局命名策略（适合表列名已经是驼峰格式的场景） #

在项目的application配置文件中添加JPA命名策略配置，让Hibernate直接使用@Column中指定的名称，不做自动转换：

application.yml 配置示例 #

spring:
  jpa:
    hibernate:
      naming:
        # 物理命名策略使用标准实现，保留@Column指定的名称
        physical-strategy: org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
        # 隐式命名策略使用JPA标准实现
        implicit-strategy: org.hibernate.boot.model.naming.ImplicitNamingStrategyJpaCompliantImpl

application.properties 配置示例 #

spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
spring.jpa.hibernate.naming.implicit-strategy=org.hibernate.boot.model.naming.ImplicitNamingStrategyJpaCompliantImpl

方案二：调整注解列名（适合表列名是下划线蛇形格式的场景） #

如果不想修改全局配置，直接修改实体类中@Column的name属性，以及索引配置的列名，和Hibernate转换后的格式保持一致即可：

1. 修改复合主键类的字段注解：

@Embeddable
internal class ProcessEventId : Serializable {
    // 列名改为下划线格式
    @Column(name = "process_id", nullable = false, length = 100)
    var processId: String? = null

    // 列名改为下划线格式
    @Column(name = "event_id", nullable = false, length = 100)
    var eventId: String? = null

    // 其余代码保持不变
}

2. 修改实体类的索引配置：

@Table(name = "process_event", indexes = [
    // 索引列名改为下划线格式
    Index(name = "pe_eventId_idx", columnList = "event_id")
])
@Entity
internal class ProcessEvent {
    @EmbeddedId
    var id: ProcessEventId? = null
}

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