Spring Boot启动Hibernate警告：添加非空列失败问题排查

1. 修正复合主键类的字段映射 #

因为使用了@Embeddable复合主键，必须在主键类的对应字段上配置@Column注解，明确指定数据库实际列名并标记非空——之前如果只在主实体类上加注解是无效的：

@Embeddable
public class YourCompositePK implements Serializable {
    // 强制指定数据库列名为"roleid"，同时设置非空约束
    @Column(name = "roleid", nullable = false)
    private Integer roleId;

    // 其他主键字段同理配置
    @Column(name = "xxx", nullable = false)
    private String otherField;

    // 必须实现的构造器、equals、hashCode方法
}

2. 调整Hibernate命名策略（避免后续字段名冲突） #

如果希望Hibernate默认生成的列名和数据库现有规则一致（驼峰直接转小写无下划线），可以在配置文件中设置物理命名策略：

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

该策略会直接使用实体字段名作为数据库列名，不会自动将驼峰转为下划线，和你现有数据库的roleid列名匹配。

3. 禁用Hibernate自动DDL（推荐配合Flyway使用） #

既然已经用Flyway做数据库schema版本管理，必须关闭Hibernate的自动DDL功能，避免两者冲突：

spring:
  jpa:
    hibernate:
      ddl-auto: none

后续所有schema变更都通过Flyway的迁移脚本管理，这是生产环境的标准做法。

4. 修复现有数据冲突 #

日志报错的核心原因是Hibernate误判了列名，试图新增role_id列但数据库已有roleid列，且现有数据无对应值。处理方式：

• 确认主键类映射修正后，重启应用，警告会自动消失；
• 如果确实需要新增列，通过Flyway编写迁移脚本添加并填充数据，比如：

ALTER TABLE <table_name> ADD COLUMN roleid INT4 NOT NULL DEFAULT 1; -- 根据业务设置合理默认值

5. 批量处理同问题表 #

对另外3个出现相同问题的表，重复上述1-3步骤，检查它们的@Embeddable主键类字段映射，确保列名与数据库完全一致。

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