Laravel 7结合Hyn 5.6实现多租户时子域名路由重叠问题排查
路由匹配重叠问题的解决步骤
核心根因
当前实现存在路由注册逻辑和hyn/multi-tenant 5.6版本机制不匹配的问题:手动在全局web.php中硬编码租户域名路由、混用其他多租户包的中间件,导致Laravel路由收集器无法正确区分不同域名下的路由边界。
具体修正操作
调整路由文件的分层逻辑,移除硬编码的域名路由
之前把主站全局路由和tecnotienda.localhost的域名硬编码路由全写在同一个全局routes/web.php中,会导致无域名约束的全局路由优先匹配所有请求,覆盖带域名约束的租户路由。- 保留全局
routes/web.php中所有主站、管理员相关的路由(即从根路由/到admin路由分组结束的全部代码),完全删除文件末尾整段Route::domain('tecnotienda.localhost')包裹的租户路由代码 - 在项目根目录新建
routes/tenant.php,把所有租户域名下需要生效的路由写入该文件,不需要手动添加任何域名约束:<?php use Illuminate\Support\Facades\Route; // 以下路由会自动绑定到所有已注册的租户子域名 Route::get('/', function () { return view('tenant.welcome'); }); // 租户端登录路由 Route::get('login', 'Auth\LoginController@showLoginForm')->name('login'); Route::post('login', 'Auth\LoginController@login'); Route::post('logout', 'Auth\LoginController@logout')->name('logout'); - 确认
config/multitenancy.php中的路由配置项为默认值,没有被手动篡改:'route' => [ 'enabled' => true, 'route_file' => base_path('routes/tenant.php'), 'middleware' => [ 'web', \Hyn\Tenancy\Middleware\HostnameActions::class, ], ],
- 保留全局
移除不兼容的自定义中间件
之前参考其他多租户实现配置的EnforceTenancy中间件,是其他多租户包的专属组件,和hyn 5.6的机制不兼容,会导致路由域名判定逻辑混乱:- 从
app/Http/Kernel.php的全局中间件栈中删除自定义的EnforceTenancy引用 - 确认web中间件组中已经正确注册hyn自带的两个核心中间件:
// app/Http/Kernel.php protected $middlewareGroups = [ 'web' => [ // 原有web基础中间件(Session、CSRF、Cookie等) \Hyn\Tenancy\Middleware\HostnameActions::class, \Hyn\Tenancy\Middleware\DatabaseActions::class, ], ];
- 从
验证路由边界正确性
完成配置调整后,通过命令行校验路由列表的域名绑定是否正常:- 查看主站路由:执行
php artisan route:list --domain=localhost,应能看到所有主站首页、admin分组的路由,全部绑定到localhost域名 - 查看租户站路由:执行
php artisan route:list --domain=tecnotienda.localhost,应能看到tenant.php中定义的所有租户路由,自动绑定到对应租户域名,和主站路由完全无重叠
- 查看主站路由:执行
清理残留缓存
之前错误的路由、配置可能被系统缓存,需要依次执行命令清理:php artisan route:clear php artisan config:clear php artisan cache:clear重启本地Web服务(Valet、Nginx、Apache均可)后,分别访问两个域名即可验证匹配效果:
localhost加载主站视图,正常访问admin后台tecnotienda.localhost加载租户专属视图,正常使用租户端路由
内容的提问来源于stack exchange,提问作者Valentina Moreno
相关产品推荐
相关产品推荐

