TypeORM实体配置@Column({unique:true})报无法创建唯一索引错误

这个报错和数据库连接权限、网络问题完全无关，是TypeORM开启synchronize: true自动同步表结构时，尝试给标注了@Column({unique: true})的字段创建唯一索引失败导致的。
PostgreSQL创建唯一索引的硬性要求是：目标字段的所有非空值不能重复。当前user表中username或email字段已经存在重复值，建索引请求直接被数据库拒绝，TypeORM把schema同步阶段的错误归类为连接异常，才会出现一直重试连接的提示。报错里的could not create unique index "UQ_78a916df40e02a9deb1c4b75edb"就是PostgreSQL返回的建唯一索引失败原生错误。

注：PostgreSQL的唯一索引允许多个NULL值存在，字段存储多个空值不会触发该错误，报错必然是存在非NULL的重复值。

• 临时修改TypeORM配置，把synchronize设为false，先让项目能正常启动连上数据库，避免同步逻辑一直阻塞
• 清理user表内的重复数据，先执行SQL查出存在重复的字段值：

  -- 查重复的用户名
  SELECT username, COUNT(*) as count FROM "user" GROUP BY username HAVING count > 1;
  -- 查重复的邮箱
  SELECT email, COUNT(*) as count FROM "user" GROUP BY email HAVING count > 1;
  

  把查询出来的重复记录删除、或者修改为互不重复的值，保证两个字段所有非空值唯一
• 重复数据清理完成后，选择对应方式完成唯一约束创建：
  • 本地开发环境：把synchronize改回true重启项目，TypeORM会自动完成唯一索引创建
  • 生产/测试环境：不要开启synchronize，手动执行SQL创建唯一约束即可：

    ALTER TABLE "user" ADD CONSTRAINT "UQ_user_username" UNIQUE ("username");
    ALTER TABLE "user" ADD CONSTRAINT "UQ_user_email" UNIQUE ("email");
    

• 注意：synchronize: true配置仅适合本地开发快速调试使用，生产环境开启会有自动改表导致数据丢失、结构异常的风险，务必关闭。

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