You need to enable JavaScript to run this app. Laravel 7结合Hyn 5.6实现多租户时子域名路由重叠问题排查
优惠活动
大模型
产品
解决方案
定价
更多

Laravel 7结合Hyn 5.6实现多租户时子域名路由重叠问题排查

路由匹配重叠问题的解决步骤

核心根因

当前实现存在路由注册逻辑和hyn/multi-tenant 5.6版本机制不匹配的问题:手动在全局web.php中硬编码租户域名路由、混用其他多租户包的中间件,导致Laravel路由收集器无法正确区分不同域名下的路由边界。


具体修正操作

  • 调整路由文件的分层逻辑,移除硬编码的域名路由
    之前把主站全局路由和tecnotienda.localhost的域名硬编码路由全写在同一个全局routes/web.php中,会导致无域名约束的全局路由优先匹配所有请求,覆盖带域名约束的租户路由。

    1. 保留全局routes/web.php中所有主站、管理员相关的路由(即从根路由/到admin路由分组结束的全部代码),完全删除文件末尾整段Route::domain('tecnotienda.localhost')包裹的租户路由代码
    2. 在项目根目录新建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');
      
    3. 确认config/multitenancy.php中的路由配置项为默认值,没有被手动篡改:
      'route' => [
          'enabled' => true,
          'route_file' => base_path('routes/tenant.php'),
          'middleware' => [
              'web',
              \Hyn\Tenancy\Middleware\HostnameActions::class,
          ],
      ],
      
  • 移除不兼容的自定义中间件
    之前参考其他多租户实现配置的EnforceTenancy中间件,是其他多租户包的专属组件,和hyn 5.6的机制不兼容,会导致路由域名判定逻辑混乱:

    1. 从app/Http/Kernel.php的全局中间件栈中删除自定义的EnforceTenancy引用
    2. 确认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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 06:06:08