如何修复Laravel路由匹配异常？自定义路由被当作{id}参数匹配

问题核心是Laravel路由采用从上到下的匹配顺序，你将ranks/{ranking}这类动态路由放在了ranks/list、ranks/weekly等静态路由前面，导致系统把list、weekly、monthly识别为动态参数{ranking}的值，优先触发了show方法。

提供两种修复方式：

方式一：调整路由定义顺序 #

将静态路由（如ranks/list、ranks/weekly）放在动态路由ranks/{ranking}之前，确保系统先匹配到静态路由：

Route::get('ranks', [RankingController::class, 'index']);
Route::post('ranks', [RankingController::class, 'create']);

// 先定义所有静态路由
Route::get('ranks/list', [RankingController::class, 'plain']);
Route::get('ranks/weekly', [RankingController::class, 'weekly']);
Route::get('ranks/monthly', [RankingController::class, 'monthly']);

// 再定义动态路由
Route::get('ranks/{ranking}', [RankingController::class, 'show']);
Route::put('ranks/{ranking}', [RankingController::class, 'update']);
Route::delete('ranks/{ranking}', [RankingController::class, 'destroy']);

方式二：给动态路由添加参数约束 #

如果不想调整路由顺序，可以为{ranking}参数添加正则约束，限定它只能匹配符合你ID规则的格式（比如数字ID），这样字符串类型的list、weekly就不会被动态路由匹配：

// 为动态路由添加参数正则约束
Route::get('ranks/{ranking}', [RankingController::class, 'show'])
    ->where('ranking', '[0-9]+');
Route::put('ranks/{ranking}', [RankingController::class, 'update'])
    ->where('ranking', '[0-9]+');
Route::delete('ranks/{ranking}', [RankingController::class, 'destroy'])
    ->where('ranking', '[0-9]+');

// 原静态路由位置不变
Route::get('ranks', [RankingController::class, 'index']);
Route::post('ranks', [RankingController::class, 'create']);
Route::get('ranks/list', [RankingController::class, 'plain']);
Route::get('ranks/weekly', [RankingController::class, 'weekly']);
Route::get('ranks/monthly', [RankingController::class, 'monthly']);

两种方式中，方式一更为直接简单，是Laravel路由配置的常规最佳实践。

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