Laravel Multitenancy新增路由未在route:list显示问题排查

• 容器代码同步异常
  Docker容器内的路由文件可能未与本地修改同步。比如使用volume挂载时，文件共享机制延迟或配置错误，导致新增的路由仅存在于本地，容器内仍是旧版路由文件。
  解决：进入容器（docker-compose exec <php-container-name> bash）查看对应路由文件内容，确认是否包含新增路由；若不同步，重启容器或调整volume挂载配置，确保本地代码实时同步到容器。

• 缓存清理不彻底或权限问题
  执行php artisan route:clear和cache:clear时，可能因容器内文件权限不足，导致缓存文件未被彻底删除；或者bootstrap/cache目录下残留旧的路由缓存文件。
  解决：手动进入容器删除bootstrap/cache/下的所有路由缓存文件（如routes-v7.php）；执行清理命令时指定正确的用户权限，例如docker-compose exec --user=www-data <php-container-name> php artisan route:clear。

• 多租户路由上下文限制
  Laravel Multitenancy包通常区分中央路由（全局）和租户路由（仅租户上下文加载）。若新增路由放在租户专属路由文件（如routes/tenant.php）中，默认执行route:list时未指定租户上下文，无法显示该路由。
  解决：检查路由所在文件，若为租户路由，执行php artisan route:list --tenant=<租户ID>（替换为实际租户ID）即可查看；若需全局访问，将路由移至中央路由文件（如routes/web.php或routes/central.php）。

• 容器环境变量或运行上下文问题
  若容器内APP_ENV设为production，Laravel会自动缓存路由，可能导致清理后缓存又被重新生成；或者执行命令的容器并非应用运行的容器，导致操作无效。
  解决：检查容器环境变量，开发环境确保APP_ENV=local；若为production环境，清理缓存后需重新执行php artisan route:cache；确认执行命令的容器是应用所在的PHP容器。

• 控制器类不存在或命名空间错误
  容器内可能未同步到TenantsController类，或类的命名空间与路由中引用的不一致，导致路由加载失败（部分场景下Laravel可能静默跳过错误路由）。
  解决：进入容器检查app/Http/Controllers/TenantsController.php是否存在，确认命名空间与路由中的引用匹配。

内容的提问来源于stack exchange，提问作者Čamo