Laravel模型update时如何自动忽略请求中数据表不存在的字段

Laravel 模型的update()方法不会自动过滤传入数组中与数据表字段不匹配的键，只要传入参数包含表中不存在的列名，生成UPDATE SQL时就会带上这些非法字段，直接触发你遇到的Undefined column数据库错误。你传入的unit、lead_times、parts、spend_codes这类字段都不属于ordered_items表，直接全量传入请求参数必然报错。

按推荐优先级从高到低排列：

• 方案1：表单校验过滤（生产环境首选）
  利用Laravel自带的请求校验能力，先定义所有允许更新的表字段及校验规则，validated()方法会自动返回符合规则的合法字段，剔除所有多余参数，同时完成参数合法性校验，从根源避免非法参数传入。
  改造后的控制器代码如下：

  public function update(OrderedItem $orderedItem, Request $request): JsonResponse
  {
      // 仅列出ordered_items表中实际存在、允许被更新的字段及对应校验规则
      $validatedData = $request->validate([
          'field1' => 'string',
          'field2' => 'integer',
          'price' => 'numeric',
          'created_at' => 'date',
          // 其余表内字段按实际业务规则补充
      ]);
  
      $orderedItem->update($validatedData);
  
      return response()->jsonSuccess([
          'message' => 'Item updated',
          'item'    => $orderedItem
      ]);
  }
  

• 方案2：基于模型$fillable属性过滤
  Laravel的批量赋值机制本身要求模型配置$fillable白名单，指定允许批量更新的字段，你可以直接复用这个配置过滤请求参数。
  第一步先在模型中配置允许批量赋值的字段：

  // app/Models/OrderedItem.php
  class OrderedItem extends Model
  {
      protected $fillable = [
          'field1',
          'field2',
          'price',
          'created_at',
          'updated_at',
          // 其余ordered_items表中允许更新的字段
      ];
  }
  

  第二步在控制器中用$fillable配置过滤请求参数后再更新：

  public function update(OrderedItem $orderedItem, Request $request): JsonResponse
  {
      $updateData = $request->only($orderedItem->getFillable());
      $orderedItem->update($updateData);
  
      return response()->jsonSuccess([
          'message' => 'Item updated',
          'item'    => $orderedItem
      ]);
  }
  

• 方案3：自动读取表结构过滤（无需手动维护字段列表）
  如果不想手动维护字段列表，可以直接读取数据库中ordered_items表的真实列名，自动筛出匹配的请求参数再更新：

  use Illuminate\Support\Arr;
  
  public function update(OrderedItem $orderedItem, Request $request): JsonResponse
  {
      // 自动获取当前模型对应表的所有字段名
      $tableColumns = $orderedItem->getConnection()
          ->getSchemaBuilder()
          ->getColumnListing($orderedItem->getTable());
      // 仅保留请求参数中与表字段匹配的键
      $updateData = Arr::only($request->all(), $tableColumns);
  
      $orderedItem->update($updateData);
  
      return response()->jsonSuccess([
          'message' => 'Item updated',
          'item'    => $orderedItem
      ]);
  }
  

  注意：该方案必须配合模型$fillable配置使用，否则请求中如果传入id、user_id这类不允许随意修改的敏感字段，会被直接更新，存在越权风险。

你报错信息里的unit、lead_times、parts这类字段属于关联模型数据、额外计算属性或者前端临时字段，不属于ordered_items主表结构，这类字段即使做了过滤也不会被更新，需要单独编写对应关联更新、属性处理逻辑，不能和主表字段一起批量更新。

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