如何调整Ecto Changeset适配GraphQL平级字段的注册需求？

当然可以！完全不用每次手动折腾参数转换和错误扁平化，我们可以直接在Ecto Changeset层面搞定这个需求，让它完美适配GraphQL的输入格式。

1. 修改Changeset，直接处理顶层email字段 #

核心思路是在Changeset函数内部，把GraphQL传入的顶层email字段，自动转换成cast_assoc需要的嵌套格式，同时保留关联表的验证逻辑。

假设你原来的Account Changeset是这样的：

def changeset(account, attrs) do
  account
  |> cast(attrs, [:username, :password])
  |> cast_assoc(:emails, required: true)
  |> validate_required([:username, :password])
end

我们可以改成这样：

def changeset(account, attrs) do
  attrs = 
    # 检查是否传入了顶层email字段，存在的话转成嵌套格式
    if email = attrs["email"] || attrs[:email] do
      # 注意：如果是has_one关联，用%{email: email}；has_many就用[%{email: email}]
      Map.put(attrs, :emails, [%{email: email}])
    else
      attrs
    end

  account
  |> cast(attrs, [:username, :password])
  |> cast_assoc(:emails, required: true)
  |> validate_required([:username, :password])
  # 把关联表的错误移到顶层，方便GraphQL返回
  |> flatten_email_errors()
end

2. 扁平化关联表的错误（关键优化） #

上面的flatten_email_errors/1函数，能把Emails表的验证错误（比如邮箱格式不对、重复）从嵌套的:emails字段移到顶层，这样返回给GraphQL客户端的错误格式更直观：

defp flatten_email_errors(changeset) do
  # 提取关联表的所有错误
  email_errors = 
    changeset
    |> Ecto.Changeset.get_change(:emails, [])
    |> Enum.flat_map(& &1.errors)
    |> Enum.map(fn {field, {msg, opts}} -> {field, {msg, opts}} end)

  # 将错误合并到顶层，并移除原嵌套错误
  changeset
  |> Ecto.Changeset.delete_change(:emails)
  |> Ecto.Changeset.add_errors(email_errors)
end

比如如果邮箱格式不合法，错误会直接出现在:email字段下，而不是嵌套在:emails[0].email里，前端处理起来更省心。

3. 可选：兼容两种参数格式 #

如果你的系统还需要支持原有嵌套emails的参数（比如后台管理接口），可以加个判断，优先使用嵌套参数，没有的话再用顶层email：

attrs = 
  unless Map.has_key?(attrs, :emails) || Map.has_key?(attrs, "emails") do
    if email = attrs["email"] || attrs[:email] do
      Map.put(attrs, :emails, [%{email: email}])
    else
      attrs
    end
  else
    attrs
  end

这样你的Changeset就同时适配两种参数格式，灵活性拉满。

为什么这么做更合理？ #

• 所有逻辑封装在Changeset里，符合Ecto“数据验证集中处理”的设计理念
• 不需要在GraphQL Resolver里写额外的参数转换代码，代码更整洁
• 错误处理统一，前端不用适配嵌套错误格式，减少沟通成本

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