必须将子域名路由组（Route::domain()）放在根域名路由之前注册，否则租户请求会被根路由拦截；需在RouteServiceProvider的mapWebRoutes()中调整顺序，确保Nginx泛解析、Host头传递、Session域设置及数据库隔离同步生效。
核心问题在于：Laravel 路由匹配是**自上而下、先到先得**，且子域名路由（Route::domain()）和根域名路由（如 Route::get('/')）属于不同匹配维度——但若注册顺序或结构不当，就会出现“租户域名请求被根域名路由吃掉”或“根域名页面无法访问”的冲突。
必须把子域名路由组放在最前面
这是最关键的一步。Laravel 会逐条比对路由定义，一旦某条路由匹配成功就立即分发，不再继续往下找。如果根域名的泛匹配路由（比如 Route::get('/{any}', ...)->where('any', '.*') 或 Vue/React 的前端路由 fallback）写在前面，那么 shop.example.com/ 这类请求虽然 Host 是子域名，但 Laravel 在进入 Route::domain() 逻辑前，已因路径 / 匹配了根路由而终止匹配。
- ✅ 正确顺序：先注册所有
Route::domain(...)分组，再注册根域名的Route::middleware('web')->group(...) - ❌ 错误写法：在
routes/web.php里直接写Route::domain(...)—— 它不会生效，因为Route::domain()必须在RouteServiceProvider::mapWebRoutes()阶段注册 - ? 实操位置：打开
app/Providers/RouteServiceProvider.php，在mapWebRoutes()方法内，把子域名路由组代码放在require base_path('routes/web.php');之前
确保 Web 服务器支持泛解析并正确转发
即使 Laravel 路由写对了，如果 Nginx/Apache 没把 tenant1.example.com 这类请求真正交给 Laravel 处理，一切配置都白搭。
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- ? Nginx 示例配置：
server_name *.example.com;，且root和index指向 Laravel 的public/目录 - ? 本地开发验证：在
/etc/hosts中添加多行，例如：127.0.0.1 test.example.com、127.0.0.1 api.example.com - ⚠️ 注意：不能只靠 DNS 泛解析就认为 OK，必须确认 HTTP Host 头真实到达 Laravel —— 可在中间件中
dd($request->getHost())验证
避免路由参数和 fallback 的干扰
根域名下的 catch-all 路由（常见于 SPA 应用）极易破坏子域名逻辑。
- ? 删除或注释掉类似
Route::fallback(...)或Route::any('{any}', ...)->where('any', '.*')这类全局兜底路由 - ✅ 若必须保留 SPA fallback，仅限根域名路径，且需明确排除子域名场景：可用中间件判断
$request->getHost()是否含点号或是否为预期主域名，再决定是否放行 - ? 补充技巧：在子域名路由组内，可加
->middleware('prevent-root-access')类中间件，防止租户用户意外访问/login等本该由主站处理的路径
数据库与会话隔离要同步验证
路由不冲突只是第一步。若租户请求进了正确分组，但数据库没切到对应租户库，或 Cookie 域名没设对，用户仍会看到错乱数据或登录失效。
- ? SESSION_DOMAIN 必须设为
.example.com（带前导点），否则tenant1.example.com的 Cookie 不会被example.com共享，反之亦然 - ? 租户识别中间件中，务必通过
$request->route('tenant')获取值，并查库校验有效性，失败应返回 404 或重定向，而非静默降级 - ? 切换数据库后调用
DB::purge('tenant')，避免连接复用导致跨租户数据泄露
