Laravel路由异常：点击生成PDF按钮跳转至错误路由页面

算力阿峰

2026-7-24

Laravel 生成PDF按钮跳转错误的排查与解决

一、检查路由定义顺序

Laravel路由按定义顺序匹配，若带slug的通用路由写在/generate-pdf前面，会导致/generate-pdf被识别为slug参数，进而匹配到员工详情页路由。

错误写法：

Route::middleware('auth')->group(function () {
    // 通用slug路由会优先匹配所有单参数路径，包括/generate-pdf
    Route::get('/{slug}', [EmployeeController::class, 'show'])->name('employee.show');
});

Route::get('/generate-pdf', [GeneratePDFController::class, 'show_pdf'])->name('pdf.generate');

正确写法：
将固定路径的路由放在通用路由之前：

// 先定义固定路径的PDF生成路由
Route::get('/generate-pdf', [GeneratePDFController::class, 'show_pdf'])->name('pdf.generate');

Route::middleware('auth')->group(function () {
    Route::get('/{slug}', [EmployeeController::class, 'show'])->name('employee.show');
});

二、检查生成PDF按钮的链接配置

确保按钮的href指向正确的PDF生成路由，避免和查看按钮的路由混淆。若需要传递员工slug参数，需同步修改路由定义。

1. 需传递员工参数的情况

先修改路由添加参数：

Route::get('/generate-pdf/{slug}', [GeneratePDFController::class, 'show_pdf'])->name('pdf.generate');

再调整按钮链接：

<a href="{{ route('pdf.generate', ['slug' => $employee->slug]) }}" class="btn">生成PDF</a>

2. 无需传递参数的情况

直接指向PDF生成路由即可：

<a href="{{ route('pdf.generate') }}" class="btn">生成PDF</a>

三、验证控制器方法逻辑

确认GeneratePDFController的show_pdf方法正确返回目标视图，无错误跳转逻辑：

public function show_pdf($slug = null)
{
    // 若需要员工数据，先查询后传递给视图
    if ($slug) {
        $employee = \App\Models\Employee::where('slug', $slug)->firstOrFail();
        return view('tAngajati.genereaza-pdf', compact('employee'));
    }
    // 无需参数时直接返回视图
    return view('tAngajati.genereaza-pdf');
}