Laravel 9控制器向Blade模板传参失败：Undefined variable问题排查

算力阿峰

2026-8-1

Laravel Blade「Undefined variable: uploads」问题排查与解决

以下是针对变量传递异常的具体排查和修复步骤：

确认路由与控制器方法的绑定
检查路由配置，确保访问/dashboard时确实调用了对应的show方法，同时添加auth中间件保证用户已登录：
```
// routes/web.php
Route::get('/dashboard', [YourController::class, 'show'])->middleware('auth');
```
若路由指向了其他未传递$uploads变量的方法，必然会触发变量未定义错误。

修正模型类的命名与引入
Laravel模型遵循大驼峰命名规范，需正确引入并调用：

// controller.php 顶部添加模型引入
use App\Models\Media;

public function show()
{
    $uploads = Media::with('user')
            ->where('user_id', auth()->user()->id)
            ->latest()
            ->get();

    return view('dashboard', compact('uploads'));
}

小写的media::会导致类找不到，触发控制器异常，无法正常传递变量到视图。

替换compact为显式数组传递变量
暂时改用数组传递变量，排除compact的潜在问题：
```
return view('dashboard', ['uploads' => $uploads]);
```

验证控制器执行流程
在控制器方法中添加调试代码，确认变量赋值和方法执行路径：

public function show()
{
    if (!auth()->check()) {
        abort(403);
    }

    $uploads = Media::with('user')
            ->where('user_id', auth()->user()->id)
            ->latest()
            ->get();

    // 打印变量确认数据是否存在
    dd($uploads);

    return view('dashboard', ['uploads' => $uploads]);
}

若dd($uploads)能输出集合（即使是空集合），说明变量赋值正常；若直接抛出错误，需优先排查用户认证或模型查询逻辑。