门面调用失败主因是服务未绑定、键名不一致或缓存未清：需确保getfacadeaccessor()返回值与register()中bind/singleton键名完全一致，绑定写在register()而非boot()，且执行php artisan config:clear。
门面调用失败，八成不是 Facade 类写错了，而是服务没绑进容器、键名不一致，或者别名没刷新缓存。
Facade 调用报 Target class [xxx] does not exist 怎么查
这个错误表面是类找不到，实际几乎全是容器绑定环节出问题。Laravel 门面在 __callStatic() 中通过 app($key) 拿实例，$key 就是 getFacadeAccessor() 返回的字符串——它必须和 register() 里 singleton() 或 bind() 的第一个参数完全一致（大小写、空格、点号都敏感）。
- 检查
getFacadeAccessor()返回值，比如是'logger.service'，那绑定语句就必须是$this->app->singleton('logger.service', ...)，不能是'logger_service'或'LoggerService' - 确认绑定写在服务提供者的
register()方法里，而不是boot()——boot()执行时门面可能已初始化完毕，容器还没来得及绑 - 运行
php artisan config:clear，Laravel 会缓存config/app.php里的aliases，改了不清理就永远提示 Class not found
自定义 Facade 必须写的三部分代码
少一个环节，调用就会中断。不是“可选”，是硬性依赖链。
- 服务类：比如
App\Services\PaymentService，要有你想调用的 public 方法，如charge() - 门面类：继承
Illuminate\Support\Facades\Facade，重写getFacadeAccessor()，返回字符串键名（如'payment.service'），路径和命名空间必须严格匹配文件位置 - 容器绑定：在
AppServiceProvider::register()中执行$this->app->singleton('payment.service', PaymentService::class)或闭包形式
别名配置后还是 Class 'Payment' not found
别名只解决「怎么写」的问题，不解决「类在哪」或「有没有注册」的问题。错误提示里的 Payment 是你配置在 aliases 数组里的 key，但 PHP 实际加载的是 value 对应的类路径——如果那个路径不存在，或命名空间/文件名对不上，就会直接报这个错。
- 检查
config/app.php的'aliases'数组中是否写了类似'Payment' => \App\Facades\PaymentFacade::class - 确认
App\Facades\PaymentFacade这个类真实存在于app/Facades/PaymentFacade.php，且文件头 namespace 正确 - 不要在控制器里
use App\Facades\PaymentFacade后再写PaymentFacade::xxx()——别名已全局注册，这么写反而绕过别名机制，容易因自动加载失败被误判
为什么不能把 Facade 当普通类注入到构造函数
Facade 类没有 __construct()，也不该被容器实例化。你写 public function __construct(PaymentFacade $payment)，Laravel 会尝试 new 它，结果就是 Target [App\Facades\PaymentFacade] is not instantiable。
- 门面只支持静态调用，如
Payment::charge(100) - 若需在类中复用，应注入服务接口或具体实现类（如
PaymentService），而不是门面本身 - 测试时也一样：mock 接口或实现类，而不是 mock 门面——门面只是代理，mock 它等于 mock 一层转发逻辑，没意义
最常被忽略的其实是绑定时机和缓存清理：register() 和 config:clear 这两步，看似简单，但跳过任何一个，门面就动不了。不是语法问题，是运行时上下文缺失。
