Laravel 设置默认 locale 后路由ID参数被替换为语言值问题排查

你将带{locale}前缀的路由组包裹了资源路由，路由系统会按参数顺序传递参数，{locale}是第一个参数，资源路由的id参数是第二个，你控制器方法只接收一个参数时拿到的自然是locale值。另外默认情况下路由的所有参数都会注入到控制器方法中，没有预留locale参数位就会出现参数错位。

解决方案 #

方法一：修改控制器参数顺序（快速适配） #

所有路由组内的控制器方法都需要将$locale作为第一个参数接收，不需要使用可以忽略：

// AboutController.php
public function edit(string $locale, int $id)
{
    $singleRow = About::find($id); 
    $allRows = About::all();
    return view('about', compact('allRows','singleRow'));
}

调整后你第一种编辑按钮的写法就可以正常运行，不需要手动传locale参数。

方法二：优化中间件避免locale参数注入（推荐，适配所有控制器） #

修改Localization.php中间件，移除路由参数中的locale，避免注入到控制器方法，同时加合法性校验避免非法语言参数：

public function handle(Request $request, Closure $next)
{        
    $locale = $request->segment(1);
    // 校验语言合法性，fallback到默认语言
    if (!in_array($locale, config('app.available_locales'))) {
        $locale = config('app.fallback_locale');
    }
    URL::defaults(['locale' => $locale]);
    app()->setLocale($locale);
    // 核心：移除路由参数里的locale，不会传递到控制器方法
    $request->route()->forgetParameter('locale');
    return $next($request);
}

修改后不需要调整任何控制器的参数写法，原代码的edit方法可以直接使用，编辑按钮也不需要手动传locale参数。

可选优化：统一资源路由参数名 #

如果不想使用资源路由默认的about参数名，可以在路由定义时指定参数为id，避免传参混淆：

// web.php
Route::resource('/about', AboutController::class)
    ->parameters(['about' => 'id'])
    ->middleware('auth');

关于Missing parameter: about错误的说明 #

这个错误出现在你注释了URL::defaults配置后，生成路由时系统找不到默认的locale参数，虽然你手动传了两个参数，但因为控制器没有预留第一个locale参数位，参数匹配错位导致系统认为你没有传入about参数，按上面两种方法调整后即可解决。

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