Ecto多表查询：如何将关联表数据返回为嵌套Map

这是Ecto的默认行为哦——即便你已经在Schema里正确定义了关联关系，它也不会自动加载关联表的数据，必须显式告知它要预加载这些关联内容。下面给你几种实现预期返回格式的方法：

方法1：使用preload/3预加载关联 #

这是最常用的方式，适用于需要完整加载关联表数据的场景。

首先确认你的Schema关联定义正确，比如Table1的Schema应该是这样的（假设是has_one关联）：

defmodule MyApp.Table1 do
  use Ecto.Schema

  schema "table1" do
    field :id, :integer
    # 其他字段...
    has_one :table2, MyApp.Table2
  end
end

然后修改你的查询，加入preload选项：

query = from t1 in MyApp.Table1, preload: [:table2]

# 执行查询并转成Map格式
result = Repo.all(query) |> Enum.map(&Map.from_struct/1)

这样返回的结果就会是类似：

[%{"id" => 1, "table2" => %{"id" => 1}}]

如果你需要把键名改成大写的"Table2"，可以手动调整Map的键：

formatted_result = Enum.map(result, fn item ->
  Map.put(item, "Table2", item["table2"]) |> Map.delete("table2")
end)

方法2：结合Join与预加载（筛选关联数据时用） #

如果需要对关联表添加筛选条件，可以先join关联表，再指定预加载该关联的查询结果：

query = from t1 in MyApp.Table1,
        join: t2 in assoc(t1, :table2),
        where: t2.id == ^target_id, # 自定义筛选条件
        preload: [table2: t2]

result = Repo.all(query) |> Enum.map(&Map.from_struct/1)

方法3：用select_merge直接合并关联字段 #

如果只需要关联表的部分字段，不需要完整加载整个结构体，可以用select_merge直接在查询阶段把关联字段合并到结果中：

query = from t1 in MyApp.Table1,
        join: t2 in assoc(t1, :table2),
        select_merge: %{table2: map(t2, [:id])} # 只选择关联表的id字段

result = Repo.all(query)

这种方式返回的结果会直接包含table2字段，不需要额外预加载步骤，适合精简数据的场景。

注意事项 #

• 确保preload里的关联名称（比如:table2）和Schema中定义的完全一致（原子名称要匹配）；
• 如果是has_many类型的关联，预加载后返回的会是列表而非单个Map，比如"table2s" => [%{id: 2}, %{id: 3}]；
• 转成Map时，Ecto结构体默认会把字段名转成小写蛇形，如果需要其他格式（比如大驼峰），可以手动处理或使用第三方序列化工具。

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