Laravel 子域名路由优先级配置指南

laravel 中子域名路由未生效，通常是因为其注册顺序在主域名路由之后，导致根域名的 / 路由提前匹配并拦截请求；正确做法是将 Route::domain(…) 分组声明置于所有根域名路由之前。

laravel 中子域名路由未生效，通常是因为其注册顺序在主域名路由之后，导致根域名的 `/` 路由提前匹配并拦截请求；正确做法是将 `route::domain(…)` 分组声明置于所有根域名路由之前。

在 Laravel 中，路由匹配遵循定义顺序优先（First Match Wins）原则：框架按 routes/web.php 中路由声明的先后顺序依次比对请求 URI 和域名，一旦找到匹配项即终止匹配、执行对应控制器逻辑。因此，若你将子域名路由（如 Route::domain(‘{slug}.domain.pl’)->group(…)）写在根域名路由（如 Route::get(‘/’, …)）之后，当访问 companyname.domain.pl/ 时：

• Laravel 首先检查根域名下的 / 路由（即 Route::get(‘/’, ‘HomeController@index’)）；
• 由于该路由未限定域名，默认匹配任意域名（包括 companyname.domain.pl），因此请求被错误地导向首页，而永远不会进入子域名分组。

✅ 正确的修复方式是：将子域名路由组前置声明，确保其优先参与匹配。

✅ 正确的路由注册顺序（修改后 routes/web.php 片段）

// ✅ 第一步：优先注册子域名路由（关键！） Route::domain('{slug}.domain.pl')->group(function () {     Route::get('/', [CompanyController::class, 'company'])->name('company.subdomain'); });  // ✅ 第二步：再注册根域名（domain.pl）的所有路由 Route::middleware('web')->group(function () {     Route::get('/', [HomeController::class, 'index'])->name('home');     Route::get('/p/{slug}', [PageController::class, 'textPage'])->name('textPage');      Route::get('/o-nas', [PageController::class, 'aboutUs'])->name('aboutUs');     Route::get('/integracja', [PageController::class, 'integration'])->name('integration');     Route::get('/jak-dzialamy', [PageController::class, 'howWeDoing'])->name('howWeDoing');     Route::get('/cennik', [PageController::class, 'priceList'])->name('priceList');     Route::get('/kontakt', [PageController::class, 'contact'])->name('contact'); // 注意：原代码中 /kontakt 指向 aboutUs，建议修正为独立方法      Route::get('/rejestracja-firmy', [RegistrationController::class, 'registrationCompany'])->name('registrationCompany');     Route::get('/rejestracja', [RegistrationController::class, 'registrationIndividual'])->name('registrationIndividual');      Route::post('/zarejestruj-firme', [RegistrationController::class, 'registrationCompanyCreate'])->name('registrationCompanyCreate');     Route::post('/zarejestruj-uzytkownika-indywidualnego', [RegistrationController::class, 'registrationIndividualCreate'])->name('registrationIndividualCreate');     Route::get('/active-user/{token}/{userId}', [RegistrationController::class, 'activeUser'])->name('activeUser');      Route::match(['get', 'post'], '/logowanie', [LoginUserController::class, 'login'])->name('loginUser');     Route::match(['get', 'post'], '/przypomnij-haslo', [LoginUserController::class, 'forgot'])->name('forgotUserPassword');     Route::match(['get', 'post'], '/przypomnij-haslo2/{token}/{email}', [LoginUserController::class, 'forgot2'])->name('forgotUserPassword2');      Route::match(['get', 'post'], '/polec-nas', [RecommendingController::class, 'recommending'])->name('recommending');     Route::get('/polityka-prywatnosci', [PageController::class, 'privacyPolicy'])->name('privacyPolicy');      Route::get('/firma/{slug}', [CompanyController::class, 'company'])->name('company');     Route::get('/oblicz-cene', [CompanyController::class, 'calculatePrice'])->name('calculatePrice');     Route::get('/oblicz-cene-rabatu', [CompanyController::class, 'calculateDiscountPrice'])->name('calculateDiscountPrice'); });

? 补充验证与注意事项

• 域名解析与本地开发支持：
  在本地测试时（如使用 laravel.test 或 domain.pl），需确保 /etc/hosts 添加通配符映射：

  # macOS / Linux 127.0.0.1 domain.pl 127.0.0.1 *.domain.pl  # ⚠️ 大多数系统不支持 * 通配符 hosts，应改为： 127.0.0.1 companyname.domain.pl 127.0.0.1 another.domain.pl

  推荐使用 Laravel Valet（自动支持 *.test）或 Docker + nginx 配置泛域名虚拟主机。

• 控制器参数接收：
  确保 CompanyController@company 正确接收子域名参数：

  public function company(string $slug, Request $request) {     // $slug 自动注入为子域名部分（如 companyname）     Log::info("Subdomain slug: {$slug}");     return view('company.show', compact('slug')); }

• 命名冲突规避：
  建议为子域名路由显式命名（如 ‘company.subdomain’），避免与根域名同名路由（如 ‘company’）混淆，便于 route() 辅助函数调用和调试。

• 中间件影响：
  若子域名需特殊中间件（如 subdomain.auth），应在 Route::domain() 分组内统一应用，而非依赖全局中间件。

✅ 总结

子域名路由失效的根本原因不是语法错误，而是路由注册顺序违反了 Laravel 的匹配机制。只需将 Route::domain(…) 分组移至 routes/web.php 顶部（早于所有根域名路由），即可确保子域名请求被精准捕获。这是 Laravel 官方推荐且经过验证的最佳实践——简洁、可靠、无需额外包或复杂配置。