Laravel路由模型绑定异常：传入字符串而非StatusPage模型

为啥会报这个错？核心是路由模型绑定没生效，UUID字符串没被自动转成StatusPage模型实例，直接以字符串塞给方法参数了。下面是你可能遗漏的点和解决办法：

1. 补全StatusPage模型的UUID配置 #

只设$incrementing = false不够，还得明确告诉Laravel主键是字符串类型：

// app/Models/StatusPage.php
class StatusPage extends Model
{
    public $incrementing = false;
    protected $keyType = 'string'; // 必须加这行
    // 其他模型代码...
}

Laravel默认主键是整数，不指定$keyType的话，框架会硬把UUID转成整数，查不到模型自然就绑定失败，只能传原始字符串。

2. 调整控制器方法的参数顺序 #

虽然Laravel允许参数位置灵活放，但为了避免歧义，把Request放到最前面更稳妥（或者保证路由参数和方法参数顺序完全对应）：

public function show(Request $request, User $user, StatusPage $statusPage)
{
    // 原来的业务逻辑不变
    return new ApiSuccessResponse(null, [
        'user' => $user,
        'statuspage' => $statusPage
    ]);
}

注：原参数顺序理论上也能跑，但调整后更符合常规写法，减少踩坑概率。

3. 确认嵌套路由的关联关系 #

你的路由是嵌套在account下的，Laravel会自动做范围绑定（只查当前用户的StatusPage），得确保User模型里有正确的关联方法：

// app/Models/User.php
public function statusPages()
{
    return $this->hasMany(StatusPage::class);
}

如果关联方法名不是statusPages（比如叫status_pages），得在路由里明确指定参数对应关系：

Route::apiResources([
    'account.status-pages' => [StatusPageController::class, 'parameters' => [
        'status-pages' => 'status_page'
    ]],
]);

不过默认情况下，Laravel会自动把status-pages转成statusPage关联，只要模型里有对应方法就行。

4. 清一下路由缓存（可选） #

要是之前生成过路由缓存，新配置可能没生效，跑个命令清缓存：

php artisan route:clear

验证 #

改完之后再调用接口：
GET http://localhost:8000/api/account/1/status-pages/f062f572-7273-4fba-a61c-17a3039e5d34
这时候UUID应该能正确转成StatusPage实例，错误就没了。

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