Laravel 7中$model->save()返回NULL但数据已保存问题咨询

Laravel 框架原生的save()方法本身固定返回布尔值：true代表保存流程正常执行完成，false代表保存被模型事件拦截、或数据库操作执行失败。出现数据写入成功但返回值为null的情况，全部是业务代码改写了方法返回逻辑导致，常见触发场景有两类：

• 模型事件/观察者逻辑错误：在boot/booted方法中注册的saving、creating、updating等钩子闭包/方法，没有显式返回true，闭包默认返回的null会被框架透传，覆盖save()方法原本的布尔返回值。
  典型错误代码示例：

  protected static function booted()
  {
      static::saving(function ($model) {
          $model->update_time = now();
          // 无显式return，默认返回null，覆盖原save返回值
      });
  }
  

• 重写save()方法不规范：在模型类、或全局模型扩展中重写了save()方法，但执行完逻辑后没有返回父类save()的执行结果，方法默认返回null。
  典型错误代码示例：

  public function save(array $options = [])
  {
      // 自定义前置校验、字段填充逻辑
      parent::save($options);
      // 未return父类执行结果，方法默认返回null
  }
  

• 优先根治返回值异常问题：排查所有模型相关的钩子、观察者、方法重写逻辑，所有不拦截保存流程的事件处理逻辑必须显式return true；重写save()方法时必须在末尾加return parent::save($options);，修复后save()会恢复原生的布尔返回值，可直接作为判断依据。
• 临时兜底判断方案：如果暂时无法定位返回值被改写的位置，不要直接依赖save()的返回值，可使用以下两种可靠判断逻辑：
  • 通过模型变更状态判断：执行save后调用wasChanged()方法，检测目标字段是否真的完成写入，该方法不受save返回值被改写的影响：

    $model = Model::find(1);
    $model->attr = $someValue;
    $model->save();
    // 检测attr字段是否成功写入数据库，返回true即为保存成功
    $saveSuccess = $model->wasChanged('attr');
    

  • 事务+异常捕获判断：将保存逻辑包裹在数据库事务中，同时捕获执行过程中的所有异常、拦截事件返回false的场景，是容错率最高的判断方式：

    use Illuminate\Support\Facades\DB;
    
    $saveSuccess = false;
    DB::transaction(function () use ($model, $someValue, &$saveSuccess) {
        $model->attr = $someValue;
        $res = $model->save();
        // 非null返回值为false时，代表保存被事件拦截，抛出异常回滚
        if (!is_null($res) && !$res) {
            throw new \RuntimeException('Save intercepted by model event');
        }
        $saveSuccess = true;
    });
    

注意：不要用!empty($saveStatus)直接判断返回null的save结果，会把实际写入成功的场景误判为失败。

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