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 官方推荐且经过验证的最佳实践——简洁、可靠、无需额外包或复杂配置。
