Laravel 9中自定义更新方法的隐式绑定为何失效？

问题核心是路由参数名与控制器方法的模型参数名不匹配，Laravel的隐式绑定机制要求路由参数名和控制器里的模型变量名完全一致，才能自动查询并注入对应的模型实例。

你新增的路由用的是{id}参数，但控制器方法里声明的是Entity $entity，Laravel没法把id参数和$entity变量关联起来，所以无法完成隐式绑定，最终返回空的模型实例。

修复步骤 #

1. 修改路由参数名，把{id}改成{entity}，和控制器的模型参数名保持一致：

Route::apiResource('entities', EntityController::class);
Route::patch('/entities/{entity}/{section}',[EntityController::class, 'updateSection' ]);

2. 控制器方法无需改动，保持原参数声明即可：

public function updateSection(UpdateEntityRequest $request, Entity $entity, $section)
{
    return $entity;
}

为什么原update方法正常工作？ #

因为Route::apiResource生成的默认路由中，更新接口的参数名是{entity}（比如PUT /entities/{entity}），和控制器update方法里的Entity $entity参数名完全匹配，所以隐式绑定能正常触发。

如果坚持要使用{id}作为路由参数名，也可以手动指定绑定规则，但不如遵循Laravel的约定更简洁：

Route::patch('/entities/{id}/{section}',[EntityController::class, 'updateSection' ])
    ->where('id', '[0-9]+')
    ->bindings([
        'id' => fn ($value) => Entity::findOrFail($value)
    ]);

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