Laravel中通过Tinker向中间表插入关联数据失败求助

问题场景 #

尝试通过中间表关联Profile与Group模型，在Tinker中实现将学生Profile添加到学习Group，但多次操作均无法将数据写入数据库，调用fresh()后关联集合仍为空。

模型关联定义 #

Profile模型 #

public function isStudentInGroup() 
{
    return $this->belongsToMany(Group::class);
}

Group模型 #

public function hasStudents() 
{
    return $this->belongsToMany(Profile::class);
}

Tinker操作尝试 #

先获取实例：

$profile = Profile::find(1);
$group = Group::find(1);

尝试以下操作均抛出BadMethodCallException错误：

$profile->isStudentInGroup->save($group);
$profile->isStudentInGroup->save($group->id);
$profile->isStudentInGroup->attach($group->id);
Profile::find(1)->isStudentInGroup->push(1)->update();
Profile::find(1)->isStudentInGroup->push(1)->save();

其中$profile->isStudentInGroup->push($group)看似返回了包含pivot数据的集合：

$profile->isStudentInGroup->push($group)
=> Illuminate\Database\Eloquent\Collection {#4646
 all: [
   App\Models\Group {#5012
     id: "1",
     start_time: "2022-09-05 18:10:00",
     end_time: "2022-09-05 19:00:00",
     created_at: null,
     updated_at: null,
     pivot: Illuminate\Database\Eloquent\Relations\Pivot {#5020
       profile_id: "1",
       group_id: "1",
     },
   },
 ],
}

但调用$profile->save()或$profile->update()时，抛出错误：

BadMethodCallException with message 'Method Illuminate\Database\Eloquent\Collection::update does not exist.'

错误原因 #

核心问题是混淆了关联方法的两种调用方式：

• 不带括号调用（$profile->isStudentInGroup）：返回的是Eloquent\Collection实例，这是已经加载到内存的关联数据集合，只能执行集合的遍历、筛选等操作，没有save()、attach()这类数据库写入方法。
• 带括号调用（$profile->isStudentInGroup()）：返回的是BelongsToMany关联关系实例，它封装了多对多关联的数据库操作逻辑，提供save()、attach()、sync()等方法用于写入中间表。

正确解法 #

使用带括号的关联方法调用，执行写入操作：

$profile->isStudentInGroup()->save($group);

此外，也可以使用attach()方法直接关联ID：

$profile->isStudentInGroup()->attach($group->id);

原理说明 #

Eloquent关联方法的两种调用逻辑：

1. 当不带括号调用时，Laravel会自动执行关联查询，把结果封装成Collection返回，这个过程叫「懒加载」。
2. 当带括号调用时，返回的是关联关系的查询构建器实例，可以通过它调用关联操作方法，或者追加查询条件后再执行查询。

内容的提问来源于stack exchange，提问作者Valentin Massart