为何无法在Eloquent模型上访问BelongsToMany关联方法？

我有两个模型List和Item，二者为多对多关系。由于只需要获取列表中的项，不关心项所属的列表，所以模型仅定义了单向关联：

class App\Models\List extends Model
{
    protected function items(): Illuminate\Database\Eloquent\Relations\BelongsToMany
    { /*...*/ }
}

设置了一条路由：

Route::post('/list/{item}', [ListController::class, 'item'])

表单会向该路由提交项及其他数据，控制器负责获取正确的List模型并存储关联及详情：

class App\Http\Controllers\ListController extends Controller
{
    public function item($request, App\Models\Item $item)
    {
        /* 请求验证 */

        $list = self::current();

        $list->items()->detach($item->id);
        $list->items()->attach($item->id, [/* 其他数据 */]);

        $list->save();

        return back();
    }

    static function current(): App\Models\List
    { /*...*/ }
}

但每次提交请求都会收到错误提示：

Call to undefined method App\Models\List::items()

已做排查 #

• 打印ListController::current()的结果，确认返回的是App\Models\List实例，且包含数据库中的数据（若存在）。
• 已确认返回BelongsToMany是正确的关联类型。
• 无需直接访问中间表即可从List实例返回Item实例，说明表结构与模型定义匹配。
• 已确认请求和路由按预期向控制器传递数据。

最初使用->syncWithoutDetaching()，但出现相同错误，为简化问题改用->attach()和->detach()。

错误的核心原因是关联方法items()被定义为protected权限，而Laravel的Eloquent关联方法必须是public权限才能被外部调用。

Laravel的关联解析依赖公开方法实现动态逻辑，当你在控制器中调用$list->items()时，protected方法无法被实例外部访问，程序会误判为尝试调用静态方法，从而抛出“未定义静态方法”的错误。

修改模型中的关联方法权限为public即可解决：

class App\Models\List extends Model
{
    public function items(): Illuminate\Database\Eloquent\Relations\BelongsToMany
    { 
        // 保留原有关联逻辑，比如：
        return $this->belongsToMany(Item::class);
    }
}

另外补充两个优化点：

1. List是PHP保留关键字，作为模型类名可能引发潜在问题，建议重命名为TodoList或其他非保留字名称。
2. 控制器item方法的参数顺序有误，Laravel依赖注入中请求实例需放在参数最前面，修正后：

// 需先引入Request类：use Illuminate\Http\Request;
public function item(Request $request, App\Models\Item $item)
{
    // ...原有逻辑
}

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