从Hibernate实体移除NotNull字段后数据库报错的优雅解决方法

你遇到的这个坑我之前也踩过！直接手动删数据库字段确实有点“简单粗暴”，下面几个更优雅的方案适配不同场景，你可以按需选择：

1. 用Hibernate自动同步Schema（测试环境友好） #

Hibernate自带了Schema自动更新能力，只需要调整配置文件参数就行。比如在Spring Boot的application.properties里：

spring.jpa.hibernate.ddl-auto=update

把这个值从none或validate改成update后重启应用，Hibernate会自动对比实体与数据库的差异，把实体中已删除的字段从数据库表中移除。

⚠️ 注意：这个方式不推荐在生产环境使用，自动DDL操作存在误删数据的风险，测试环境快速验证用它很高效。

2. 数据库迁移工具（生产环境首选） #

对于生产环境，最稳妥的方式是用专门的数据库迁移工具，比如Flyway或Liquibase，所有Schema变更都通过版本化脚本管理，可追溯、可回滚：

• Flyway示例：创建一个符合命名规范的SQL脚本（比如V1_0_1__remove_old_field.sql），内容为删除旧字段：

  ALTER TABLE your_table_name DROP COLUMN old_field_name;
  

  启动应用时，Flyway会自动执行该脚本，保证数据库Schema与实体完全一致。
• Liquibase示例：用XML/YAML定义变更集，比如XML格式：

  <changeSet id="remove-old-user-field" author="your-name">
    <dropColumn tableName="user" columnName="old_field"/>
  </changeSet>
  

  这种方式还能兼容多种数据库，适合复杂的Schema变更场景。

3. 平滑过渡方案（在线服务不中断） #

如果你的应用是在线运行的，直接删字段怕影响旧数据或未更新的客户端，可以分两步走：

• 第一步：先给数据库里的旧字段添加默认值，避免插入报错：

  ALTER TABLE your_table_name MODIFY COLUMN old_field_name VARCHAR(255) DEFAULT '';
  

  这样新数据插入时会自动用默认值填充，不会触发异常，同时旧数据也不受影响。
• 第二步：等确认所有业务代码都不再依赖这个旧字段后，再用迁移工具或Hibernate自动更新把它删掉。

4. 临时应急方案（不推荐长期使用） #

如果暂时没时间处理数据库，也可以临时在实体里（若你只是刚删字段还没提交代码）给旧字段加个注解：

@Column(insertable = false, updatable = false)
private String oldFieldName;

这个注解会让Hibernate在插入和更新时忽略该字段，暂时绕过异常，但这只是权宜之计，最终还是要同步Schema，不然数据库里的冗余字段会一直存在，留下隐患。

总的来说，生产环境优先选数据库迁移工具，测试环境可以用Hibernate自动更新，在线服务就用平滑过渡的方式，根据你的场景选择即可~

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