如何在Rails 6中使用graphql-ruby实现仅更新传入字段的模型更新

你当前遇到的报错和字段覆盖问题，本质来自两个实现细节的偏差：

• 代码存在笔误：resolve方法签名中声明了release_date参数，但类层面从未定义对应的argument :release_date配置，本身就会触发参数不匹配的异常
• 没有区分「可选参数的方法签名要求」和「前端实际传入的参数」：目前你把所有可选字段都列为resolve方法的必填关键字参数，前端不传这些字段时自然会抛missing keywords的错误；如果按相关issue的建议给这些参数加= nil默认值，就没法区分「用户没传这个字段不想修改」和「用户明确传nil要清空字段」的场景，直接把值塞进update参数里就会覆盖原有数据。

之前官方issue提到的「给可选参数设nil默认值」的方案，本质是解决Ruby方法关键字参数必须显式声明的报错，但会把所有未传入的字段强制填充为nil，根本无法区分两类场景，直接用于模型更新就必然会覆盖原有数据。

graphql-ruby 内置提供了arguments方法，可以直接拿到前端实际传入的、未经过默认值填充的原始参数hash，完全不需要把所有可选字段都列在resolve的方法签名里，具体改造点如下：

1. 保持id作为必填参数的校验逻辑不变，类层面的argument配置全部保留，不需要给可选参数加额外的默认值
2. 修正代码里漏写的release_date参数声明（如果确实需要支持更新这个字段的话）
3. resolve方法只显式接收必填的id参数，剩下的更新字段全部从arguments返回的hash里取，只把用户实际传入的、允许更新的字段传给模型的update方法
4. 天然支持两类使用场景：用户只传了watched就只更新这一个字段；用户明确传了某个字段为nil就可以正常清空对应值

module Mutations
  module Media
    class UpdateMedia < GraphQL::Schema::Mutation
      include ::GraphqlAuthenticationConcerns
      include ::GraphqlActiveModelConcerns

      description 'Update Media'
      # 必填参数：保留原有校验
      argument :id, Integer, required: true
      # 可选更新参数：全部保持 required: false，不需要加默认值
      argument :title, String, required: false
      argument :release_date, GraphQL::Types::ISO8601Date, required: false # 补充原代码漏声明的参数
      argument :preview_url, String, required: false
      argument :preview_image, String, required: false
      argument :watched, Boolean, required: false

      field :success, Boolean, null: false
      field :errors, [Types::ActiveModelError], null: false
      field :media, Types::MediumType, null: false

      # 这里只显式接收必填的id参数，不再列所有可选字段
      def resolve(id:)
        authenticate_user!

        media = Medium.find(id)
        # 白名单允许更新的字段，从原始入参里只取用户实际传了的键
        allowed_update_fields = [:title, :release_date, :preview_url, :preview_image, :watched]
        media_params = arguments.to_h.slice(*allowed_update_fields)

        if media.update(media_params)
          success_response(media)
        else
          failed_response(media)
        end
      end

      private

      def success_response(media)
        {
          success: true,
          errors: [],
          media: media
        }
      end

      def failed_response(media)
        {
          success: false,
          errors: errors(media)
        }
      end
    end
  end
end

• 完全避免字段覆盖问题：未传入的字段不会被填充为nil进入更新参数，不会修改模型上用户没提的字段
• 保留全部原生校验逻辑：所有声明的argument的类型、格式校验完全生效，不会因为改造跳过安全校验
• 满足核心增量更新诉求：用户传啥就更新啥，id作为必填参数的校验逻辑不受任何影响
• 支持明确清空字段的场景：如果用户传某字段值为null，这个值会正常被包含在更新参数里，正常触发模型的字段清空逻辑，不会被过滤掉

额外安全提示：一定要用白名单（slice的字段列表）过滤允许更新的字段，不要直接把arguments.to_h全量传给update方法，避免恶意传参修改模型上不该暴露的字段（比如用户关联ID、创建时间、软删除标记等）。

内容的提问来源于stack exchange，提问作者J. Jackson