PostgreSQL分区表外键创建失败：无匹配唯一约束问题求助

问题根源 #

PostgreSQL对分区表的约束有严格要求：

• 分区表的主键/唯一约束必须包含分区键，否则仅能保证分区内唯一性，无法确保全局唯一
• 外键引用的字段必须对应被引用表的全局唯一约束/主键，你的units表仅用id作为主键（未包含分区键created_at），数据库无法确认id的全局唯一性，因此拒绝创建外键。

步骤1：修正units分区表的主键（添加分区键到复合主键） #

修改units表的迁移代码，将主键设置为id + created_at的复合主键，满足PostgreSQL的分区约束要求：

create_range_partition :units, partition_key: :created_at, template: false do |t|
  # 显式定义UUID类型的id，自动生成默认值
  t.uuid :id, default: -> { "gen_random_uuid()" }, null: false
  t.belongs_to :course, type: :uuid, null: false, foreign_key: true

  # ... 其他业务字段

  t.timestamps

  # 设置复合主键（必须包含分区键created_at）
  t.primary_key [:id, :created_at]
end

执行迁移后，可通过\d units命令验证：主键已变为(id, created_at)的复合约束。

步骤2：修改lessons分区表的外键引用（匹配复合主键） #

由于units的主键是复合字段，lessons表需要同时存储unit_id和unit_created_at，并创建复合外键：

create_range_partition :lessons, partition_key: :created_at, template: false do |t|
  # 存储units表的复合主键对应的两个字段
  t.uuid :unit_id, null: false
  t.datetime :unit_created_at, null: false

  # ... 其他业务字段

  t.timestamps

  # 创建复合外键，关联units的复合主键
  t.foreign_key :units, 
                columns: [:unit_id, :unit_created_at], 
                primary_key: [:id, :created_at]
end

业务逻辑适配提示 #

后续关联unit和lesson时，需要同步unit_created_at字段，可在Rails模型中添加回调实现：

class Lesson < ApplicationRecord
  belongs_to :unit, foreign_key: [:unit_id, :unit_created_at], primary_key: [:id, :created_at]

  before_validation :sync_unit_created_at
  private

  def sync_unit_created_at
    self.unit_created_at = unit&.created_at
  end
end

步骤3：普通表引用分区表的适配 #

如果有普通表需要引用units表，同样遵循复合外键规则：

1. 在普通表中添加unit_id和unit_created_at字段
2. 创建复合外键关联units的复合主键，示例迁移代码：

create_table :some_regular_table do |t|
  t.uuid :unit_id, null: false
  t.datetime :unit_created_at, null: false

  # ... 其他字段
end

add_foreign_key :some_regular_table, :units, 
                columns: [:unit_id, :unit_created_at], 
                primary_key: [:id, :created_at]

验证迁移 #

1. 回滚之前的错误迁移（如果已执行）：rails db:rollback
2. 依次执行修改后的units和lessons迁移：rails db:migrate
3. 通过\d lessons命令查看外键约束是否成功创建

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