Spring JPA：如何修改已建立实体的ID数据类型？

问题描述 #

• 核心需求：Spring项目中需将某实体的ID从String类型改为自动生成的Long类型，同时更新所有子实体关联的新数字ID。
• 初步困境：尝试用Flyway脚本修复，但需删除自动生成的外键，担心生产环境外键名不一致，不敢贸然操作，求稳妥过渡方式。

第一次编辑（遇到的具体报错） #

尝试新增id_v2字段做过渡，子表同步新增parent_id_v2字段，但Hibernate创建外键约束时触发报错：

Error executing DDL "alter table website$blog add constraint FK50amru4p1wg4jq0stsw8distc foreign key (website_id_v2) references website (id_v2)" via JDBC [Failed to add the foreign key constraint. Missing index for constraint 'FK50amru4p1wg4jq0stsw8distc' in the referenced table 'website'

实体代码片段：

@Getter @Setter
private String id;
@Getter @Setter @Id @GeneratedValue(strategy=GenerationType.AUTO)
private Long id_v2;

第二次编辑（临时解决方法） #

给父表添加索引后问题暂时解决，但不确定是否合理：

@Table(name="store$website", indexes= @Index(name = "idx_store$website_id_v2", columnList = "id_v2"))

推荐的平滑过渡方案 #

步骤1：新增Long类型ID并初始化数据 #

• 父实体新增id_v2字段，用@GeneratedValue(strategy=GenerationType.IDENTITY)替代AUTO（更明确适配数据库自增逻辑），暂时保留原id字段且不标记为@Id。
• 用Flyway脚本批量给现有父记录生成id_v2值（比如利用数据库自增序列，或批量插入逻辑生成唯一Long值）。
• 给父表的id_v2加唯一索引（比普通索引更贴合ID的唯一性要求，同时解决外键索引缺失问题）：

  CREATE UNIQUE INDEX idx_store$website_id_v2 ON store$website(id_v2);
  

步骤2：同步子实体关联字段数据 #

• 子实体新增parent_id_v2字段，对应父表的id_v2。
• 用Flyway脚本批量更新子表数据，基于原parent_id关联关系同步id_v2值：

  UPDATE website$blog b
  SET b.website_id_v2 = w.id_v2
  FROM store$website w
  WHERE b.website_id = w.id;
  

• 手动用Flyway脚本创建外键约束（自己指定外键名，避免Hibernate自动生成的名称不一致问题）：

  ALTER TABLE website$blog
  ADD CONSTRAINT fk_website_blog_id_v2
  FOREIGN KEY (website_id_v2) REFERENCES store$website(id_v2);
  

步骤3：切换为主ID并清理旧字段 #

• 待全量数据同步完成后，将父实体的@Id注解从原id移到id_v2上，同时移除原id的映射配置（若无需保留旧字段）。
• 用Flyway脚本删除原id字段、子表的原parent_id字段，以及对应的旧外键约束（提前用SHOW CREATE TABLE查询生产环境外键名，确保脚本准确）。

关于临时方案的合理性 #

你给父表加索引的操作是正确的——数据库要求外键关联字段必须有索引（否则关联查询会触发全表扫描，性能极差）。不过更推荐加唯一索引，因为id_v2作为未来的主键，本身需要唯一性保证，比普通索引更适配场景。

内容的提问来源于stack exchange，提问作者Sael Torres-Diaz