Laravel运行出现Undefined variable: data报错如何排查解决

排查步骤 #

• 校验路由配置是否正确
  绝大多数该类报错都是路由指向错误导致：打开routes/web.php，确认对应访问路径的路由是指向PostController的index方法，而非直接返回视图的闭包写法。
  错误的闭包路由示例（未传$data变量）：

  // 错误写法，没有传递$data到视图
  Route::get('/posts', function () {
      return view('posts.index');
  });
  

  正确的路由写法：

  use App\Http\Controllers\PostController;
  
  Route::get('/posts', [PostController::class, 'index']);
  

• 确认视图文件路径与命名正确
  控制器返回的视图路径是posts.index，对应文件必须存放于resources/views/posts/index.blade.php，检查目录名、文件名是否存在拼写错误、大小写不匹配问题。
• 校验控制器变量传递逻辑
  检查PostController的index方法中，变量名、compact参数是否拼写一致，compact的参数必须是字符串形式的变量名，大小写要和定义的变量完全匹配。
• 临时调试验证变量传递
  1. 在控制器return语句前加dd($data);，访问对应路由如果能正常输出分页数据，说明控制器逻辑正常
  2. 在视图文件最顶部加{{ dd($data ?? '变量未传递到视图') }}，如果输出变量未传递到视图，可确认问题出在路由或视图路径配置环节。

修复方案 #

1. 优先修正路由配置，确保路由指向PostController的index方法
2. 可以替换控制器的参数传递写法，避免compact拼写失误：

public function index()
{
    $data = Post::latest()->paginate(5);
    // 用数组显式传参，更直观不易出错
    return view('posts.index', [
        'data' => $data,
        'i' => (request()->input('page', 1) - 1) * 5
    ]);
}

3. 可以在视图中增加变量存在判断，避免异常直接抛出：

@if(isset($data) && $data->count())
    @foreach ($data as $key => $value)
    <tr>
        <td>{{ ++$i }}</td>
        <td>{{ $value->title }}</td>
        <td>{{ \Str::limit($value->description, 100) }}</td>
        <td>
            <form action="{{ route('posts.destroy',$value->id) }}" method="POST">
                <a class="btn btn-info" href="{{ route('posts.show',$value->id) }}">Show</a>
                <a class="btn btn-primary" href="{{ route('posts.edit',$value->id) }}">Edit</a>
                @csrf
                @method('DELETE')
                <button type="submit" class="btn btn-danger">Delete</button>
            </form>
        </td>
    </tr>
    @endforeach
@else
    <tr>
        <td colspan="4">暂无帖子数据</td>
    </tr>
@endif

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