Laravel 9控制器可选参数报错问题咨询

错误原因 #

问题出在Laravel的参数解析顺序：

• 当路由里的{id?}是可选参数时，如果请求没传id，Laravel会把依赖注入的UserService（UserInterface的实现类）塞到第一个参数位置，但你的方法第一个参数声明的是?int $id，类型不匹配就抛出了错误。
• 把id设为必填参数时，请求必须传入id，框架会先把路由参数赋值给第一个参数，再处理后面的依赖注入，所以能正常运行。

修复方案 #

有两种简单的解决方式：

方式一：调整参数顺序（推荐） #

把依赖注入的接口参数放在可选路由参数前面，让框架先处理依赖注入，再处理路由参数：

class UserController extends Controller
{
    public function getSoleUserProfile(
        UserInterface $users,
        ?int $id = null,
    ) {
        // 你的业务逻辑
    }
}

这样不管请求有没有传id，框架都能正确识别每个参数的类型和来源。

方式二：给路由参数指定默认值 #

如果不想调整参数顺序，可以在路由里显式给可选参数设置默认值，确保框架能正确解析参数位置：

Route::get('/users/profile/{id?}', [UserController::class, 'getSoleUserProfile'])->defaults('id', null);

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