为何Laravel中withTrashed()无法配合控制器隐式绑定使用？

架构老林

2026-6-13

问题：Laravel控制器隐式绑定路由无法使用withTrashed()？

我们知道Laravel的控制器支持隐式绑定，示例如下：

路由定义：

use App\Http\Controllers\UserController;

Route::get('/users/{user}', [UserController::class, 'show']);

控制器代码：

// app/Http/Controllers/UserController.php

namespace App\Http\Controllers;
use App\Models\User;

class UserController extends Controller
{
    public function show(User $user) // 类型提示
    {
        return "User email is: " . $user->email; // Laravel会自动执行findOrFail()
    }
}

但Laravel文档说明withTrashed()可用于路由隐式绑定，比如闭包路由示例：

Route::get('/admin/users/{user}', function (User $user) {
    return view('admin.show-user', ['user' => $user]);
})->withTrashed(); // 告知路由需要包含软删除的数据

但将withTrashed()加到控制器隐式绑定的路由上却不生效，例如：

use App\Http\Controllers\UserController;

Route::get('/users/{user}', [UserController::class, 'show'])->withTrashed();

控制器代码不变：

// app/Http/Controllers/UserController.php

namespace App\Http\Controllers;
use App\Models\User;

class UserController extends Controller
{
    public function show(User $user) 
    {
        return "User email is: " . $user->email;
    }
}

为什么控制器隐式绑定场景下使用withTrashed()不生效？

回答

控制器隐式绑定的路由本身是可以使用withTrashed()的，你遇到的不生效情况，通常是由以下几个原因导致的：

路由缓存未清除：Laravel的路由缓存会固化已定义的路由规则，如果你在添加withTrashed()之前已经生成过路由缓存，新的路由配置不会生效。执行以下命令清除缓存即可：
```
php artisan route:clear
```
模型未启用软删除：如果你的User模型没有引入SoftDeletes trait，withTrashed()方法本身不会对查询产生任何影响——因为模型根本不支持软删除逻辑。需要在模型中添加该trait：
```
// app/Models/User.php
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;

class User extends Model
{
    use SoftDeletes;
}
```
路由顺序冲突：如果在当前路由之前，存在另一个匹配/users/{user}的路由定义，请求会被先匹配的路由处理，导致你添加的withTrashed()规则无法生效。确保带withTrashed()的路由定义在其他同匹配规则的路由之前。

自定义路由绑定逻辑覆盖：如果你的User模型重写了resolveRouteBinding或resolveRouteBindingQuery方法，且没有保留原生的withTrashed处理逻辑，会导致路由上的withTrashed()失效。此时需要在自定义方法中加入对路由标记的判断：

protected function resolveRouteBindingQuery($query, $value, $field = null)
{
    // 先调用父类的原生逻辑
    $query = parent::resolveRouteBindingQuery($query, $value, $field);

    // 保留withTrashed的处理逻辑
    if (request()->route()->getAction('withTrashed')) {
        $query->withTrashed();
    }

    return $query;
}

替代方案

如果不想依赖路由的withTrashed()标记，也可以直接在控制器方法中控制查询逻辑，这种方式更直观：

public function show($userId) 
{
    $user = User::withTrashed()->findOrFail($userId);
    return "User email is: " . $user->email;
}

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

为何Laravel中withTrashed()无法配合控制器隐式绑定使用？

替代方案 #

替代方案