Laravel {lang}路由前缀报缺少lang参数问题排查修复

• 你将{lang}设置为路由组的必填前缀参数后，Laravel默认不会自动从当前请求上下文继承该参数填充到路由生成逻辑中，所有组内命名路由调用route()助手生成URL时，必须传入lang参数，否则就会抛出参数缺失异常。
• 你手动传入固定语言标识（如fa）时页面正常运行，已经排除了路由定义、视图语法错误的可能，问题核心就是路由生成环节没有自动携带当前请求的lang值。
• 原有路由定义中路由组闭包传入$lang参数是无效写法，Laravel路由组闭包不需要接收前缀参数，该写法不会对参数传递产生任何作用。

整个修复逻辑不需要改动原有视图的路由调用写法，通过全局默认参数绑定实现lang参数自动注入，完全符合你不使用Session的要求。

1. 配置路由全局默认参数 #

修改app/Providers/RouteServiceProvider.php的boot方法，为lang参数设置全局默认值，让所有route()调用自动携带当前请求的语言标识：

public function boot()
{
    $this->configureRateLimiting();

    $this->routes(function () {
        Route::middleware('api')
            ->prefix('api')
            ->group(base_path('routes/api.php'));

        Route::middleware('web')
            ->group(base_path('routes/web.php'));
    });

    // 为lang参数设置默认值，优先取当前请求的路由参数，不存在则用系统默认语言
    \URL::defaults(['lang' => request()->route('lang') ?? config('app.locale')]);
}

2. 完善language中间件逻辑 #

修改app/Http/Middleware/Language.php，完成语言合法性校验、应用语言设置、默认参数绑定的逻辑，非法语言请求自动重定向到默认语言路径：

public function handle(Request $request, Closure $next)
{
    // 配置项目实际支持的语言标识列表
    $supportedLanguages = ['en', 'fa', 'zh'];
    $defaultLanguage = config('app.locale');

    $currentLang = $request->route('lang');
    // 传入的语言不合法时，重定向到默认语言对应路径
    if (!in_array($currentLang, $supportedLanguages)) {
        $pathSegments = explode('/', trim($request->path(), '/'));
        // 移除路径开头无效的语言段
        $pathWithoutInvalidLang = implode('/', array_slice($pathSegments, 1));
        return redirect(rtrim('/' . $defaultLanguage . '/' . $pathWithoutInvalidLang, '/'));
    }

    // 设置应用当前生效语言
    app()->setLocale($currentLang);
    // 绑定当前合法语言为URL全局默认参数，后续路由生成自动携带
    \URL::defaults(['lang' => $currentLang]);

    return $next($request);
}

3. 修正路由定义 #

修改routes/web.php，移除路由组闭包的无效参数，补充根路径重定向逻辑，确保所有带语言前缀的路由都在组内定义：

// 访问根路径时自动跳转到默认语言前缀的首页
Route::get('/', function () {
    return redirect('/' . config('app.locale'));
});

// 移除闭包的$lang参数，该参数无实际作用
Route::group(['middleware' => ['language', 'navbar'], 'prefix' => '{lang}'], function () {
    Route::get('/', [App\Http\Controllers\HomeController::class, 'index'])->name('home');
    Auth::routes();
    
    Route::get('/page/{id}/{slug?}', [\App\Http\Controllers\PageController::class, 'show'])->name('page.show');
    Route::post('basket/add/{id}', [\App\Http\Controllers\ProductController::class, 'basket_add'])->name('basket.add.item');
    // 确保product.show路由定义在该组内
    Route::get('/product/{id}', [\App\Http\Controllers\ProductController::class, 'show'])->name('product.show');
});

修复效果 #

• 所有视图内的route()调用不需要手动传入lang参数，系统会自动拼接当前访问的语言前缀，不会再出现参数缺失报错。
• 整个逻辑完全基于URL前缀实现，没有任何Session读写操作，符合你的方案要求。
• 非法语言前缀的访问会自动重定向到默认语言路径，不会出现404错误。

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