Rails使用insert_all!批量插入UUID主键记录报错解决方案咨询

1. 让insert_all!尊重Postgres的gen_random_uuid()默认值 #

要实现由数据库自动生成UUID，需从模型配置、插入操作、迁移配置三方面调整：

模型层配置 #

因使用tenant_id + id复合主键，需在模型中正确声明主键，并告知Railsid字段由数据库生成：

class YourJoinModel < ApplicationRecord
  self.primary_key = [:tenant_id, :id]
  # 让Rails不自动生成id值，交由数据库默认逻辑处理
  attribute :id, :uuid, default: -> { nil }
end

插入操作调整 #

使用insert_all!时，不要在待插入的哈希中包含id字段。若记录哈希自带id键，需先剔除：

# 假设records是包含待插入数据的数组，每个元素含tenant_id等关联字段
clean_records = records.map { |r| r.except(:id) }
YourJoinModel.insert_all!(clean_records)

迁移配置验证 #

确保迁移文件中id字段的默认值配置正确：

create_table :your_join_table, id: :uuid, default: -> { "gen_random_uuid()" }, primary_key: [:tenant_id, :id] do |t|
  t.uuid :tenant_id, null: false
  # 其他关联字段
  t.index [:tenant_id, :id], unique: true
end

同时检查structure.sql中的表定义，确认id字段的默认值确实为gen_random_uuid()。

2. 在Rails中生成与Postgres兼容的UUID #

Postgres的gen_random_uuid()生成的是UUID v4，Rails的SecureRandom.uuid同样生成UUID v4，二者结构完全一致。你感知到的"不一致"大概率是大小写差异（Postgres存储UUID为小写），只需将生成的UUID转为小写即可：

# 生成与Postgres兼容的UUID v4
uuid = SecureRandom.uuid.downcase

批量插入场景下，SecureRandom.uuid是最优方案，无需额外调用数据库函数。

内容的提问来源于stack exchange，提问作者R. Barrett