TypeORM修改实体复合主键列名时报relation主键约束不存在错误

• 同步逻辑冲突：配置中同时开启了synchronize: true和使用迁移功能，二者功能重叠。synchronize会自动根据实体结构修改数据库表结构，会导致数据库实际的约束状态和TypeORM生成迁移时读取的元数据预期不一致，触发迁移逻辑判断错误。
• TypeORM自动生成迁移的逻辑缺陷：针对联合主键变更的场景，TypeORM自动生成迁移时没有正确校验主键约束的存在状态，生成了重复的删除主键语句。你的迁移文件中第一次执行DROP CONSTRAINT "PK_439cf7d31c1f020884802168a8c"后该约束已被删除，第二次执行同一条语句时就会触发约束不存在的报错。
• 主键和外键的关联逻辑冲突：你原来的主键列同时是@JoinColumn指定的外键关联列，修改主键字段后，TypeORM在处理外键删除、主键变更、非空约束修改的优先级时逻辑混乱，生成了大量冗余重复的DDL语句，进一步放大了问题。

临时修复当前报错 #

1. 先将ormconfig.ts中的synchronize改为false，该配置只适合本地开发调试用，生产环境绝对不能开启，避免自动修改表结构导致数据丢失。
2. 删除本次自动生成的错误迁移文件，手动编写迁移逻辑，不要依赖自动生成的内容：

public async up(queryRunner: QueryRunner): Promise<void> {
  // 先删除原有联合主键
  await queryRunner.query(`ALTER TABLE "public"."follows" DROP CONSTRAINT "PK_3f7767cc6077ad78f956bffc8a7"`);
  // 新增两个新的主键字段
  await queryRunner.query(`ALTER TABLE "public"."follows" ADD "followerAddressNew" character varying NOT NULL`);
  await queryRunner.query(`ALTER TABLE "public"."follows" ADD "followeeAddressNew" character varying NOT NULL`);
  // 给新字段设置联合主键
  await queryRunner.query(`ALTER TABLE "public"."follows" ADD CONSTRAINT "PK_follows_new" PRIMARY KEY ("followerAddressNew", "followeeAddressNew")`);
  // 取消原有字段的非空约束
  await queryRunner.query(`ALTER TABLE "public"."follows" ALTER COLUMN "followerAddress" DROP NOT NULL`);
  await queryRunner.query(`ALTER TABLE "public"."follows" ALTER COLUMN "followeeAddress" DROP NOT NULL`);
}

public async down(queryRunner: QueryRunner): Promise<void> {
  // 回滚逻辑反向实现即可
  await queryRunner.query(`ALTER TABLE "public"."follows" DROP CONSTRAINT "PK_follows_new"`);
  await queryRunner.query(`ALTER TABLE "public"."follows" DROP COLUMN "followerAddressNew"`);
  await queryRunner.query(`ALTER TABLE "public"."follows" DROP COLUMN "followeeAddressNew"`);
  await queryRunner.query(`ALTER TABLE "public"."follows" ALTER COLUMN "followerAddress" SET NOT NULL`);
  await queryRunner.query(`ALTER TABLE "public"."follows" ALTER COLUMN "followeeAddress" SET NOT NULL`);
  await queryRunner.query(`ALTER TABLE "public"."follows" ADD CONSTRAINT "PK_3f7767cc6077ad78f956bffc8a7" PRIMARY KEY ("followerAddress", "followeeAddress")`);
}

3. 执行手动编写的迁移即可完成字段变更。

后续开发规范 #

• 生产环境永远关闭synchronize配置，所有表结构变更都通过手动校验后的迁移文件实现。
• 涉及主键、索引、外键这类约束变更的场景，不要直接使用typeorm migration:generate自动生成的迁移，必须手动检查调整SQL语句，确认没有冗余重复操作后再执行。
• 联合主键建议使用@Entity({ primaryKeys: ['col1', 'col2'] })显式声明，减少TypeORM元数据识别错误的概率。

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