Laravel 5：服务提供者中能否使用未注册的Facade？及类找不到问题

看起来你在自定义Laravel包模板时踩了门面加载顺序的坑——package:discover的加载逻辑很容易出现这类依赖顺序问题，我帮你梳理几个最可能的原因和解决办法：

1. 先排查服务提供者的加载顺序 #

报错指向Breadcrumbs注册代码里调用了Athena门面，但大概率是Breadcrumbs相关代码在Athena服务提供者完成门面注册前就执行了。

• 解决办法：
  • 把Breadcrumbs的注册逻辑移到Athena服务提供者的boot()方法里，确保Athena门面注册完成后再执行面包屑配置。
  • 或者在你的包的composer.json的extra.laravel.providers里，把Athena的服务提供者放在Breadcrumbs相关服务提供者前面，比如：

    "extra": {
        "laravel": {
            "providers": [
                "Your\\Package\\AthenaServiceProvider",
                "Your\\Package\\BreadcrumbsServiceProvider"
            ]
        }
    }
    

2. 确认Athena门面的注册是否正确 #

如果Athena是你自定义的门面，得确保它在服务提供者里被正确绑定和注册：

• 在Athena服务提供者的register()方法里，先把底层服务绑定到容器：

  public function register()
  {
      $this->app->bind('athena', function ($app) {
          return new \Your\Package\Services\AthenaService();
      });
  }
  

• 然后在boot()方法里注册门面别名：

  public function boot()
  {
      if (!class_exists('Athena')) {
          class_alias('Your\\Package\\Facades\\Athena', 'Athena');
      }
  }
  

• 还要检查Athena门面类的getFacadeAccessor()方法，返回值要和上面绑定的容器键一致（比如'athena'）：

  protected static function getFacadeAccessor()
  {
      return 'athena';
  }
  

3. 检查Composer自动加载与命名空间 #

有时候类找不到只是因为Composer没正确加载你的包的类：

• 打开你的包的composer.json，确认autoload的PSR-4映射正确：

  "autoload": {
      "psr-4": {
          "Your\\Package\\": "src/"
      }
  }
  

• 在主应用根目录执行composer dump-autoload强制更新自动加载文件；如果你的包是本地开发用path仓库引入的，记得也在包目录里执行一次这个命令。

4. 修正Breadcrumbs文件里的代码引用 #

如果上面的都没问题，那可能是你在breadcrumbs.php里的Athena引用有误：

• 如果你没注册全局别名Athena，就需要用完整命名空间，比如\Your\Package\Facades\Athena::getFacadeRoot()。
• 或者在breadcrumbs.php文件顶部添加命名空间引入：

  use Your\Package\Facades\Athena;
  

  之后就可以直接用Athena::getFacadeRoot()了。

最后，别忘了清理缓存再测试：

php artisan cache:clear
php artisan config:clear
php artisan package:discover

内容的提问来源于stack exchange，提问作者Roban Reuvers