PostgreSQL+Sequelize迁移报错：引用表无匹配唯一约束

问题核心 #

你试图给source_number表的product_id、provider_id字段分别添加独立外键，关联product_provider表的对应字段，但PostgreSQL报错提示there is no unique constraint matching given keys for referenced table "product_provider"。原因很明确：

• PostgreSQL要求外键引用的字段必须是唯一约束或主键
• 你的product_provider表只有product_id + provider_id的组合是唯一的（组合主键/组合唯一约束），单个product_id或provider_id字段本身并不具备唯一性（比如同一个产品可以对应多个供应商），所以无法作为单个外键的引用目标。

解决方案 #

给source_number表添加组合外键，将product_id和provider_id的组合关联到product_provider表的组合主键，而非设置独立外键。

修改后的迁移代码 #

product_provider 迁移（无需修改，组合主键已满足唯一性要求）

module.exports = {
  up: async (queryInterface, Sequelize) => {
    await queryInterface.createTable('product_provider', {
      product_id: { type: Sequelize.INTEGER, allowNull: false, primaryKey: true },
      provider_id: { type: Sequelize.INTEGER, allowNull: false, primaryKey: true },
    });
    // 这里的组合唯一约束可保留，不过组合主键本身已具备唯一性，可按需选择
  },
  down: async (queryInterface) => {
    await queryInterface.dropTable('product_provider');
  },
};

source_number 迁移（修改为组合外键）

module.exports = {
  up: async (queryInterface, Sequelize) => {
    await queryInterface.createTable('source_number', {
      // 保留其他字段定义
      product_id: {
        type: Sequelize.INTEGER,
        allowNull: false,
        // 移除单个字段的references配置
      },
      provider_id: {
        type: Sequelize.INTEGER,
        allowNull: false,
        // 移除单个字段的references配置
      },
      // 其他字段...
    });

    // 添加组合外键约束
    await queryInterface.addConstraint('source_number', {
      fields: ['product_id', 'provider_id'],
      type: 'foreign key',
      name: 'source_number_product_provider_fk', // 自定义约束名称，便于后续维护
      references: {
        table: 'product_provider',
        fields: ['product_id', 'provider_id'],
      },
      onUpdate: 'CASCADE',
      onDelete: 'CASCADE',
    });
  },
  down: async (queryInterface) => {
    // 先删除外键约束，再删除表
    await queryInterface.removeConstraint('source_number', 'source_number_product_provider_fk');
    await queryInterface.dropTable('source_number');
  },
};

操作步骤 #

1. 若已执行过错误迁移，先回滚：

   npx sequelize-cli db:migrate:undo
   

2. 替换上述迁移代码后，重新执行迁移：

   npx sequelize-cli db:migrate
   

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