能否在ORM层将JSONB中的嵌套对象预加载到ActiveRecord关联？

需求背景 #

需要把PostgreSQL JSONB列中存储的多层结构对象快照，映射为ActiveRecord模型实例（包含嵌套子对象），且必须返回ActiveRecord_Relation对象，不能直接解析JSON后拼接。已实现顶层字段映射，但嵌套子对象始终返回nil。

已尝试无效方案 #

• 在子查询中使用"child_table.name"这类别名
• 调用joins(:child_table)关联子表

可行ORM层面实现方案 #

方案1：字段前缀映射+自定义关联方法 #

通过给嵌套字段添加关联名前缀，在父模型中手动组装子模型实例，完全基于ORM查询返回的结果集处理。

步骤1：扩展快照SQL生成逻辑，包含嵌套字段

修改父模型的snapshots_sql方法，同时生成顶层字段和嵌套子对象的字段，给子字段加上**关联名_**前缀：

def self.snapshots_sql
  # 生成顶层模型字段的SQL片段
  parent_fields = columns_hash.map do |col_name, props|
    "(snapshot_data->>'#{col_name}')::#{props.sql_type} AS #{col_name}"
  end.join(', ')

  # 生成嵌套子模型字段的SQL片段，假设关联名为child_table，子模型为ChildTable
  child_fields = ChildTable.columns_hash.map do |col_name, props|
    "(snapshot_data->'child_table'->>'#{col_name}')::#{props.sql_type} AS child_table_#{col_name}"
  end.join(', ')

  # 组合完整SQL
  "SELECT #{parent_fields}, #{child_fields} FROM snapshots"
end

def self.get_snapshots
  self.from("(#{snapshots_sql}) AS #{table_name}")
end

步骤2：在父模型中定义关联方法

在父模型中添加child_table方法，从前缀字段中提取属性并初始化子模型实例：

class ParentModel < ApplicationRecord
  def child_table
    @child_table ||= ChildTable.new(
      ChildTable.columns_hash.keys.each_with_object({}) do |col, attrs|
        attrs[col] = send("child_table_#{col}")
      end
    )
  end
end

调用ParentModel.get_snapshots.first.child_table即可得到填充好的子模型实例，且整个查询返回标准ActiveRecord_Relation。

方案2：LATERAL JOIN映射为关联表 #

利用PostgreSQL的LEFT JOIN LATERAL将嵌套JSON解析为子表结构，让ActiveRecord自动识别关联关系，更贴近原生ORM关联的体验。

步骤1：修改快照SQL使用LATERAL JOIN

def self.snapshots_sql
  parent_fields = columns_hash.map do |col_name, props|
    "(snapshot_data->>'#{col_name}')::#{props.sql_type} AS #{col_name}"
  end.join(', ')

  # 用LATERAL JOIN将嵌套JSON转为子模型的行结构
  sql = <<~SQL
    SELECT #{parent_fields}, child.*
    FROM snapshots
    LEFT JOIN LATERAL (
      SELECT
        (snapshot_data->'child_table'->>'id')::bigint AS id,
        (snapshot_data->'child_table'->>'name')::text AS name,
        -- 其他子模型字段
        snapshots.id AS parent_model_id -- 对应子模型的belongs_to外键
      FROM snapshots s
      WHERE s.id = snapshots.id
    ) AS child ON true
  SQL
  sql.strip
end

def self.get_snapshots
  self.from("(#{snapshots_sql}) AS #{table_name}")
end

步骤2：确保模型关联定义正确

子模型中必须定义对应的belongs_to关联：

class ChildTable < ApplicationRecord
  belongs_to :parent_model
end

class ParentModel < ApplicationRecord
  has_one :child_table, inverse_of: :parent_model
end

此时查询返回的ParentModel实例中，child_table会被ActiveRecord自动识别为关联对象，无需额外方法定义。

注意事项 #

• 如果嵌套对象是数组（一对多关联），可将LEFT JOIN LATERAL改为unnest解析JSON数组，再映射为子表行
• 需确保JSON字段的键名与模型列名完全一致，否则要在SQL中手动映射
• 若子模型有默认值或回调逻辑，初始化实例时需根据需求调整（比如用find_or_initialize_by替代new）

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