Laravel项目如何处理多级域名解析？（路由技巧）

在Lara vel中处理多级域名，路由配置是第一个关键点。实话实说，Route::domain() 方法确实支持子域名绑定，但有个前提：你得把完整的域名模式写清楚，别指望它能像正则一样模糊匹配。

如何用 Route::domain() 匹配多级子域名

Lara vel 的 Route::domain() 只接受字符串模板，里面可以放 {sub} 这样的通配符，但不支持原生正则。所以像 *.example.com 这种写法，直接不生效。

常见误解是：Route::domain('{sub}.example.com') 能通配所有子域。实际上，它确实能捕获 api.example.com 或 admin.example.com，但 v1.api.example.com 这种三级域名就无能为力了——{sub} 默认只匹配一级子域。

• 如果需要支持任意深度子域，比如 v1.api.example.com，可以改用 Route::domain('{sub}.example.com')，然后在控制器里手动解析 $sub 字符串，比如用 explode('.', $sub) 拆开
• 更稳妥的做法，是把多级子域“扁平化”：统一用二级域名承载业务，比如 api-v1.example.com，或者干脆改用路径前缀，像 example.com/v1/api/...
• 注意：Route::domain() 必须在 RouteServiceProvider 的 map() 方法中调用，不能放在闭包路由文件里，否则域名绑定时机太晚，直接失效

为什么 Request::getHost() 和 url()->to() 生成的链接可能出错

这个问题的根源在于 Lara vel 默认根据当前请求的 Host 头构建 URL，但多级域名下经常出现“路由匹配了，链接却指向错误域名”的诡异情况。比如访问 admin.example.com 时，url()->to('dashboard') 却生成 http://example.com/dashboard。

其实，问题出在 APP_URL 配置项上。它被硬编码为单域名，而 Lara vel 的 URL 生成器优先信任这个配置，而不是实际请求头。

• 一种快速修复方法：在 AppServiceProvider::boot() 中动态设置 URL::forceRootUrl(request()->getSchemeAndHttpHost())
• 更彻底的解决方案：把 APP_URL 改成空值，并确保服务器（Nginx 或 Apache）正确透传 Host 头；否则 request()->getHost() 可能返回 IP 或默认域名
• 特别注意缓存影响：如果开了路由缓存（php artisan route:cache），Route::domain() 相关路由会被固化，此时修改 APP_URL 或中间件逻辑不会实时生效

使用 Route::group(['domain' => ...]) 时的嵌套陷阱

嵌套分组看似方便，但容易踩坑：外层 domain 分组会覆盖内层定义，而且无法叠加。举个例子，Route::domain('{sub}.example.com')->group(...) 里面再写 ->domain('{v}.api.example.com')，第二个 domain() 调用会被直接忽略。

更隐蔽的问题是中间件执行顺序。域名路由分组的中间件会在请求进入控制器前运行，但如果中间件里依赖了未初始化的容器服务（比如自定义域名解析器），就会抛出 BindingResolutionException。

• 避免嵌套 domain 分组，改用单一顶层 Route::domain('{wildcard}.example.com')，然后在中间件里做细分判断
• 如果需要按子域加载不同配置（比如数据库连接），不要在路由分组里直接调用 Config::set()，应通过服务提供者或请求生命周期早期的事件（如 booting）完成
• 测试时记得用真实 Host 头：php artisan test --filter=TestDomainRouting 不足以覆盖，要用 Http::withHeaders(['Host' => 'api.example.com'])->get('/') 模拟

本地开发时 Nginx / Valet / Sail 的域名配置差异

本地跑不通多级域名，大概率不是代码问题，而是环境配置没对齐。Valet 默认只响应 *.test，不支持 *.local.test；Sail 的 docker-compose.yml 如果没配 extra_hosts，容器内 DNS 解析会失败；Nginx 则常因 server_name 没加通配符导致 404。

• Valet：运行 valet domain test 后，再执行 valet link admin，访问 admin.test 即可；但 v1.admin.test 需要手动编辑 /etc/resolver/test 并重启 mDNSResponder
• Sail：在 docker-compose.yml 的 lara vel.test 服务下添加 extra_hosts: ["v1.api.example.com:host-gateway"]，并确保 .env 中 APP_URL 设为空
• Nginx：server_name 必须写成 server_name ~^(?.+)\.example\.com$; 才能捕获变量，单纯写 *.example.com 是无效语法

真正麻烦的从来不是怎么写路由，而是每次换环境都要重新核对 Host 头、DNS 解析、HTTPS 证书和容器网络这四层是否同时对齐——漏一个，就卡在 502 或混合内容警告里。