TypeORM迁移报错：关联表无匹配唯一约束问题排查

这个错误提示there is no unique constraint matching given keys for referenced table "user"本质是说，你要关联的user表的id字段没有唯一约束（通常是主键约束），导致post表无法创建指向它的外键。结合你的场景，我整理了几个常见的排查和解决方向：

1. 检查迁移文件的执行顺序 #

TypeORM的迁移是按文件名的时间戳顺序执行的，如果创建post表的迁移文件时间戳比创建user表的更早，就会出现post先尝试关联还没创建主键的user表的情况。

• 确认迁移文件的命名：比如user的迁移文件名应该类似1690000000000-CreateUserTable.ts，post的是1690000001000-CreatePostTable.ts，确保user的时间戳更早。
• 如果顺序反了，可以手动修改迁移文件的时间戳前缀，或者先回滚到user表创建之前的状态，重新按正确顺序执行迁移。

2. 验证user表的迁移定义是否正确 #

打开user表对应的迁移文件，检查是否正确给id字段添加了主键约束。正确的创建语句应该包含主键定义：

// 示例User迁移文件中的创建表代码
await queryRunner.createTable(
    new Table({
        name: "user",
        columns: [
            {
                name: "id",
                type: "uuid",
                isPrimary: true,
                generationStrategy: "uuid",
                default: "uuid_generate_v4()",
            },
            // 其他用户字段...
        ],
    }),
    true
);

如果你的迁移文件里id字段的isPrimary没有设为true，或者没有手动添加主键约束，那user表的id就不具备唯一约束，导致外键创建失败。

3. 手动修复数据库中的user表（临时应急方案） #

如果已经执行了部分迁移，user表已经存在但没有主键，可以直接在数据库中执行SQL添加主键约束：

ALTER TABLE "user" ADD CONSTRAINT "PK_user_id" PRIMARY KEY ("id");

执行完这条语句后，再重新运行post表的迁移命令，外键应该就能正常创建了。

4. 检查实体类的主键定义是否生效 #

虽然你说严格遵循了官方文档，但还是再确认下UserEntity的主键定义：

@Entity()
export class UserEntity {
    @PrimaryGeneratedColumn('uuid')
    id: string;

    // 其他字段和关联...
    @OneToMany(type => PostEntity, post => post.userPosted)
    posts: PostEntity[];
}

确保@PrimaryGeneratedColumn('uuid')没有被错误注释或者拼写错误，TypeORM需要这个装饰器来生成带主键约束的迁移代码。

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