Elixir Phoenix Ecto更新PostgreSQL jsonb嵌入字段报CastError解决

核心误区拆解 #

你遇到的报错和字段丢失问题，本质上踩了三个Ecto使用的常见坑：

• 变更集changeset/2的第二个入参必须是普通映射（纯%{}结构），不能直接传入Ecto Schema结构体，这就是你传整个%Setting.Setting{}时报** (Ecto.CastError) expected params to be a :map的直接原因。
• Ecto对嵌入字段（embeds_one/embeds_many）的默认更新逻辑是：如果传入的嵌套参数中没有携带对应嵌入层的持久化ID，就会整体替换整个嵌入结构，没有在参数里显式声明的字段会被置为nil——这就是你第一次只传部分cif字段时，其他嵌套JSON字段全部丢失的原因。
• Map.from_struct/1只会把最外层结构体转成普通map，不会递归处理内部嵌套的Schema结构体，无法直接生成合规的变更集入参。

更优的实现方式 #

针对你只需要修改单个嵌套字段的场景，完全不需要手动构造全量参数，推荐两种落地方法：

方法1：直接修改结构体后提交（最简洁） #

直接利用Elixir的嵌套put_in宏，在已经查询到的原始setting记录上精准修改目标字段，不会触碰其他原有值，之后直接提交给Repo更新即可，完全绕开嵌套map传参的替换逻辑：

# 假设已从数据库拿到原始的setting记录
updated_setting = put_in(
  setting.data.v1.age_risk.cif,
  true
)

# 直接提交更新
Setting.Repo.update(updated_setting)

这种方式不需要走参数类型校验，适合内部逻辑的批量字段修改场景，执行效率也更高。

方法2：走变更集流程（保留字段校验逻辑） #

如果需要保留变更集自带的字段校验、白名单过滤逻辑，只需要在构造嵌套参数时，给每一层嵌入结构带上对应的旧值ID，Ecto识别到ID后就会自动执行合并更新，不会清空其他字段：

cs_params = %{
  data: %{
    id: setting.data.id, # 携带顶层嵌入字段的ID
    v1: %{
      age_risk: %{
        id: setting.data.v1.age_risk.id, # 携带下一层嵌入字段的ID
        cif: true
      }
    }
  }
}

Setting.Setting.changeset(setting, cs_params) |> Setting.Repo.update()

注意：你Schema中对嵌入字段配置的on_replace: :delete不会影响这个逻辑——只要参数中携带了对应嵌入子结构的ID，Ecto就会执行字段合并更新，不会触发删除替换。

避坑提醒 #

不要直接把内部的Schema结构体作为变更集的参数传入，这本身违背了变更集的设计初衷：变更集是用来接收外部传入的非可信参数（比如HTTP请求参数），做类型转换、字段过滤、规则校验的，天然要求参数为纯map结构。

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