TypeORM同表双外键引用同一主键的迁移执行问题

核心问题 #

你遇到的报错是因为TypeORM默认生成的外键约束名称重复，或者外键引用配置未明确区分两个关联关系，导致Postgres识别到重复的引用列配置。以下是可直接落地的配置方案：

1. 正确配置实体类 #

Account 实体

import { Entity, PrimaryGeneratedColumn, Column } from "typeorm";

@Entity()
export class Account {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  name: string;

  // 可选：添加反向关联，帮助TypeORM明确关系映射
  // @OneToMany(() => Transaction, transaction => transaction.fromAccount)
  // outgoingTransactions: Transaction[];

  // @OneToMany(() => Transaction, transaction => transaction.toAccount)
  // incomingTransactions: Transaction[];
}

Transaction 实体（关键配置）

重点给两个外键关联指定唯一的约束名称，并明确映射字段：

import { Entity, PrimaryGeneratedColumn, Column, ManyToOne, JoinColumn } from "typeorm";
import { Account } from "./Account";

@Entity()
export class Transaction {
  @PrimaryGeneratedColumn()
  id: number;

  @Column("decimal", { precision: 10, scale: 2 })
  amount: number;

  // 转出账户外键字段
  @Column()
  fromAccountId: number;

  @ManyToOne(() => Account)
  @JoinColumn({
    name: "from_account_id", // 数据库字段名（可选，默认与实体字段名一致）
    referencedColumnName: "id", // 关联的Account主键
    foreignKeyConstraintName: "FK_transaction_from_account" // 唯一约束名，必须不同
  })
  fromAccount: Account;

  // 转入账户外键字段
  @Column()
  toAccountId: number;

  @ManyToOne(() => Account)
  @JoinColumn({
    name: "to_account_id",
    referencedColumnName: "id",
    foreignKeyConstraintName: "FK_transaction_to_account" // 第二个唯一约束名
  })
  toAccount: Account;
}

2. 重新生成并执行迁移 #

1. 删除旧迁移文件：如果之前生成过错误的迁移，先删除对应文件，避免残留错误配置。
2. 生成新迁移：

npx typeorm-ts-node-commonjs migration:generate ./src/migrations/CreateTransactionTable -d ./src/data-source.ts

3. 执行迁移：

npx typeorm-ts-node-commonjs migration:run -d ./src/data-source.ts

3. 验证迁移文件 #

生成的迁移文件中，外键约束应类似如下结构，确保两个约束名称和关联字段完全区分：

public async up(queryRunner: QueryRunner): Promise<void> {
    await queryRunner.createTable(new Table({
        name: "transaction",
        columns: [
            { name: "id", type: "int", isPrimary: true, isGenerated: true, generationStrategy: "increment" },
            { name: "amount", type: "decimal", precision: 10, scale: 2 },
            { name: "from_account_id", type: "int" },
            { name: "to_account_id", type: "int" }
        ],
        foreignKeys: [
            {
                columnNames: ["from_account_id"],
                referencedColumnNames: ["id"],
                referencedTableName: "account",
                name: "FK_transaction_from_account"
            },
            {
                columnNames: ["to_account_id"],
                referencedColumnNames: ["id"],
                referencedTableName: "account",
                name: "FK_transaction_to_account"
            }
        ]
    }), true);
}

为什么之前的配置失败？ #

• 未显式指定foreignKeyConstraintName时，TypeORM会自动生成名称，可能因两个关联关系指向同一表而重复。
• 禁用外键约束的createForeignKeyConstraints: false需配置在@ManyToOne的参数中，而非全局配置，若配置位置错误则不生效。

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