Laravel路由缓存丢失自定义租户路由问题求助

Laravel 的 route:cache 命令会在应用启动的路由加载阶段生成静态路由缓存文件，这个阶段早于服务提供者 boot 方法的执行时机。你在 boot 里动态加载的租户路由，在缓存生成时还未被注册，自然不会被纳入缓存。另外，你实现了 DeferrableProvider 接口，延迟加载的服务提供者不会在路由缓存生成阶段被实例化，进一步导致路由加载逻辑无法执行。

方法1：调整路由加载时机与服务提供者 #

1. 移除延迟加载接口
   去掉 DeferrableProvider 实现，确保服务提供者在应用启动时立即加载：

   class DomainServiceProvider extends ServiceProvider
   {
       // 保留原有代码，删除 implements DeferrableProvider
   }
   

2. 在路由扫描阶段加载租户路由
   将租户路由加载逻辑移到 RouteServiceProvider 的 map 方法中（该方法会在Laravel路由扫描阶段执行，能被route:cache捕获）：

   class RouteServiceProvider extends ServiceProvider
   {
       public function map()
       {
           $this->mapApiRoutes();
           $this->mapWebRoutes();
           $this->mapTenantRoutes(); // 新增租户路由加载方法
       }
   
       protected function mapTenantRoutes()
       {
           // 替换为你的租户查询逻辑
           Tenant::all()->each(function (Tenant $tenant) {
               Route::group([
                   'as' => "{$tenant->namespace}.",
                   'domain' => $tenant->domain,
                   'middleware' => 'web',
               ], function () use ($tenant) {
                   $this->loadRoutesFrom(app_path("Domain/{$tenant->name}/Routes/web.php"));
               });
           });
       }
   }
   

方法2：预生成静态租户路由文件 #

如果租户数据不频繁变动，可通过自定义命令预生成静态路由文件，让route:cache直接扫描该文件：

1. 创建自定义命令

   php artisan make:command GenerateTenantRoutes
   

2. 编写命令逻辑

   class GenerateTenantRoutes extends Command
   {
       protected $signature = 'tenant:routes:generate';
       protected $description = '生成静态租户路由文件';
   
       public function handle()
       {
           $content = "<?php\n\n";
           Tenant::all()->each(function (Tenant $tenant) use (&$content) {
               $routePath = app_path("Domain/{$tenant->name}/Routes/web.php");
               $routeContent = file_get_contents($routePath);
               
               // 包裹租户路由组
               $content .= "Route::group([\n";
               $content .= "    'as' => '{$tenant->namespace}.',\n";
               $content .= "    'domain' => '{$tenant->domain}',\n";
               $content .= "    'middleware' => 'web',\n";
               $content .= "], function () {\n";
               $content .= $routeContent;
               $content .= "});\n\n";
           });
           
           file_put_contents(base_path('routes/tenants.php'), $content);
           $this->info('租户路由文件生成成功！');
       }
   }
   

3. 加载静态路由文件
   在 RouteServiceProvider 的 map 方法中添加：

   protected function mapTenantRoutes()
   {
       if (file_exists(base_path('routes/tenants.php'))) {
           $this->loadRoutesFrom(base_path('routes/tenants.php'));
       }
   }
   

4. 使用流程
   每次租户数据变动后，先执行：

   php artisan tenant:routes:generate
   

   再执行路由缓存：

   php artisan route:cache
   

内容的提问来源于stack exchange，提问作者Francois M.