hyperf 中 graphql 字段级批量修改需自定义 mutation 与输入类型，用 fieldupdateinput 动态接收 key-value 更新字段，resolver 中白名单校验、类型转换后安全更新；支持单/多 id 批量操作，并可集成权限控制与审计日志。
Hyperf 中通过 GraphQL 实现字段级批量修改，核心在于**将“批量操作”建模为一个自定义 mutation 字段，配合输入类型（Input Type）动态接收目标字段与值，并在 Resolver 中按需更新对应模型属性**。它不是靠 GraphQL 自身能力“自动”实现，而是靠你对输入结构的设计和业务逻辑的控制。
设计支持字段级选择的输入类型
避免为每个实体写一堆固定字段的 InputType。用 嵌套的键值对结构 表达“改哪些字段、改成什么”，例如：
input UpdateUserFieldsInput {
id: ID!
fields: [FieldUpdateInput!]!
}
<p>input FieldUpdateInput {
key: String! # 如 "name", "status", "email"
value: String! # 值统一用 String，后端做类型转换
}</p>这样前端可自由组合要改的字段，无需服务端提前约定所有可能字段。注意：key 必须白名单校验，防止非法字段注入。
在 Resolver 中安全执行字段更新
Resolver 不直接调用 $model->update($data)，而是遍历 fields，逐个校验 + 赋值 + 类型转换：
- 检查
key是否在允许更新的字段白名单中（如['name', 'status', 'avatar_url']） - 根据字段名推断预期类型（如
status→ int，name→ string），用filter_var或 cast 方法转换 - 跳过空值或非法值（如 status 传了 "abc" 就忽略该字段）
- 使用
$model->fill([...])+$model->save()，或更稳妥地用$model->update([...])只更新指定字段
支持批量 ID + 字段更新（真·批量）
如果需要一次改多个记录的相同字段（比如：把用户 ID 1,2,3 的 status 都设为 0），可扩展 input：
input BulkUpdateUsersInput {
ids: [ID!]!
fields: [FieldUpdateInput!]!
}
Resolver 中用 User::whereIn('id', $ids)->update($safeData)，注意：这里 update 必须是静态数组（已校验+转换后的值），不能传原始 input。同时建议加事务和影响行数检查，避免误更新。
配合权限与审计更实用
字段级修改天然适合细粒度权限控制：
- 在 Resolver 开头用
$this->auth->can('update', [$user, $fieldKey])校验每字段权限 - 记录变更日志时，只记实际生效的字段（
foreach ($appliedFields as $k => $v) { Log::info("User {$id} field {$k} updated to {$v}"); }） - 对敏感字段（如 password、balance）单独拦截，强制走专用 mutation（如
changePassword）
