Spring Boot实体类列重命名后，如何同步修改数据库列名而非新增？

问题原因 #

Hibernate的spring.jpa.hibernate.ddl-auto配置（常用默认值为update）是为了安全同步实体结构到数据库设计的，它只会新增表或列，不会修改已有列的名称或删除列——这是为了防止误操作导致数据丢失，所以直接修改实体类的@Column注解，Hibernate会认为是新增了一个列，而非修改原有列。

具体实现方法 #

方法一：使用数据库迁移工具（生产环境推荐）

这类工具（如Flyway、Liquibase）是数据库结构变更的标准解决方案，能跟踪变更历史、保证执行顺序，完全可控。以Flyway为例：

1. 引入依赖
   Maven：

   <dependency>
       <groupId>org.flywaydb</groupId>
       <artifactId>flyway-core</artifactId>
   </dependency>
   

   Gradle：

   implementation 'org.flywaydb:flyway-core'
   

2. 创建迁移脚本
   在src/main/resources/db/migration目录下创建命名符合规范的SQL文件，比如V1__rename_user_id_to_users_id.sql，内容根据数据库类型调整：

   -- MySQL 示例
   ALTER TABLE users RENAME COLUMN user_id TO users_id;
   -- PostgreSQL 示例
   -- ALTER TABLE users RENAME user_id TO users_id;
   

3. 配置Flyway
   在application.properties中添加：

   spring.flyway.enabled=true
   spring.flyway.locations=classpath:db/migration
   -- 按需配置数据库账号密码
   -- spring.flyway.user=your_db_user
   -- spring.flyway.password=your_db_pwd
   

4. 启动应用
   Flyway会自动检测并执行未运行过的迁移脚本，完成列名重命名。之后修改实体类的@Column(name = "users_id")即可同步。

方法二：开发环境临时手动处理

如果是本地开发环境，数据量小且可备份，可直接手动操作：

1. 先备份users表的数据（避免意外）
2. 在数据库客户端执行重命名SQL：

   ALTER TABLE users RENAME COLUMN user_id TO users_id;
   

3. 修改实体类的@Column注解为新列名，启动应用即可。

方法三：禁用Hibernate自动DDL（生产环境建议）

生产环境绝对不要依赖ddl-auto=update维护数据库结构，建议设置为none，完全通过迁移工具管理结构变更，避免意外的结构修改。

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