Rails7.0.8中PostgreSQL按tenant_id分区后CRUD操作异常

一、ActiveRecord::IrreversibleOrderError（调用BillingScheduleLine.last报错） #

问题根源 #

Rails默认的last方法依赖主键id的全局倒序，但LIST分区表的数据分散在不同租户分区中，PostgreSQL无法直接返回全局意义上的“最后一条”记录——因为没有全局统一的排序索引支撑跨分区的高效排序。

解决方法 #

1. 显式指定排序维度
   避免直接调用无约束的last，优先限定租户范围，或指定明确的排序字段：

   # 按租户隔离查询（性能最优，推荐）
   BillingScheduleLine.where(tenant_id: current_tenant.id).order(id: :desc).first
   # 全局查询（性能较差，仅必要时使用）
   BillingScheduleLine.order(created_at: :desc, id: :desc).first
   

2. 重写模型的last方法（可选）
   如果不想修改所有调用处，可以在模型里重写last，强制带合理排序：

   class BillingScheduleLine < ApplicationRecord
     def self.last
       order(created_at: :desc, id: :desc).first
     end
   end
   

   注意：全局跨租户的last本身业务意义不大，优先推荐按租户维度查询。

二、PG::NotNullViolation（批量插入/更新时id为空） #

问题根源 #

1. 分区表的主键必须包含分区键tenant_id（PostgreSQL LIST分区的强制要求），但Rails默认仅将id设为主键，导致主键约束不完整。
2. 分区表的id字段未正确关联自增序列，批量插入时Rails无法自动生成合法的id值；或批量操作未携带tenant_id，导致无法路由到对应分区，进而触发约束错误。

解决步骤 #

1. 配置复合主键（id + tenant_id）

首先在数据库层面确保主表和所有分区的主键包含tenant_id：

-- 主表设置复合主键
ALTER TABLE billing_schedule_lines ADD PRIMARY KEY (id, tenant_id);

-- 确认所有分区继承该主键（创建分区时会自动继承，可省略此步）
ALTER TABLE billing_schedule_lines_tenant_1 ADD PRIMARY KEY (id, tenant_id);

然后在Rails模型中声明复合主键：

class BillingScheduleLine < ApplicationRecord
  self.primary_keys = [:id, :tenant_id]
end

2. 正确配置自增序列

有两种方案，根据业务规模选择：

• 方案A：全局共享序列（适合中小规模租户）
  所有分区共用一个序列，保证id全局唯一：

  -- 创建全局序列
  CREATE SEQUENCE billing_schedule_lines_id_seq;
  -- 主表id字段关联序列
  ALTER TABLE billing_schedule_lines ALTER COLUMN id SET DEFAULT nextval('billing_schedule_lines_id_seq');
  -- 所有分区同步关联该序列
  ALTER TABLE billing_schedule_lines_tenant_1 ALTER COLUMN id SET DEFAULT nextval('billing_schedule_lines_id_seq');
  ALTER TABLE billing_schedule_lines_tenant_2 ALTER COLUMN id SET DEFAULT nextval('billing_schedule_lines_id_seq');
  

• 方案B：租户独立序列（适合超大规模租户）
  每个分区使用独立序列，避免全局序列的性能瓶颈：

  -- 为租户1的分区创建独立序列
  CREATE SEQUENCE billing_schedule_lines_tenant_1_id_seq;
  ALTER TABLE billing_schedule_lines_tenant_1 ALTER COLUMN id SET DEFAULT nextval('billing_schedule_lines_tenant_1_id_seq');
  
  -- 为租户2的分区创建独立序列（以此类推）
  CREATE SEQUENCE billing_schedule_lines_tenant_2_id_seq;
  ALTER TABLE billing_schedule_lines_tenant_2 ALTER COLUMN id SET DEFAULT nextval('billing_schedule_lines_tenant_2_id_seq');
  

3. 规范批量操作写法

批量插入/更新必须携带tenant_id，确保路由到正确分区：

# 批量插入示例
BillingScheduleLine.insert_all([
  { tenant_id: 1, amount: 100, due_date: Date.tomorrow },
  { tenant_id: 2, amount: 200, due_date: Date.tomorrow }
])

# 批量更新示例（必须包含tenant_id条件）
BillingScheduleLine.where(tenant_id: 1, id: [1, 2, 3]).update_all(amount: 150)

额外注意事项 #

• 所有查询必须包含tenant_id条件，否则PostgreSQL会扫描所有分区，导致性能暴跌，甚至触发操作失败。
• Rails 7对PostgreSQL分区表的原生支持有限，复杂分区操作建议直接用原生SQL完成，避免依赖Rails迁移的自动生成逻辑。
• 若使用Rails的update/save方法，确保模型实例已设置tenant_id，否则无法正确路由到分区。

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