getFacadeAccessor() 必须返回服务容器中绑定时使用的键名（如 'sms.service' 或 SmsService::class），而非类名或命名空间；该字符串需与 singleton() 或 bind() 的第一个参数严格一致，大小写、空格、标点均不能出错。
自定义 Facade 不是写个类就能用，必须让服务容器、门面类、别名三者键名完全对齐，缺一不可。任何一处大小写、空格或路径错误，都会直接报 Target class [xxx] does not exist 或 Call to undefined method。
Facade 类里 getFacadeAccessor() 返回什么？
它必须返回你在容器中绑定时用的「键名」，不是类名，不是命名空间，就是字符串字面量。这个键名要和 singleton() 或 bind() 的第一个参数严格一致。
- 如果你写的是
$this->app->singleton('sms.service', SmsService::class)，那么getFacadeAccessor()就得返回'sms.service' - 如果用的是类名绑定：
$this->app->singleton(SmsService::class, ...)，那返回值就得是SmsService::class（即完整类名字符串） - Laravel 9+ 支持用
protected static $facadeAccessor = 'sms.service';替代方法，更轻量，但逻辑不变 - 返回值带空格、多一个点、大小写错（比如
'Sms.Service'），调用时就会找不到绑定
服务提供者 register() 里怎么绑定才生效？
绑定必须在 register() 方法里完成，不能放 boot()；且必须用 $this->app->singleton() 或 bind() 显式注册，不能只 new 实例。
- ✅ 正确：
$this->app->singleton('sms.service', function ($app) { return new SmsService($app['http']); }); - ❌ 错误：只写
new SmsService()而不进容器 —— Facade 拿不到实例，__callStatic会失败 - ❌ 错误：在
boot()中绑定 —— Facade 初始化早于boot()，此时容器里还没这个键 - 验证是否绑好：进
php artisan tinker，执行app()->bound('sms.service')应返回true；再执行app('sms.service')看能否成功实例化
为什么写了 Facade 类还报 Class not found？
绝大多数情况不是 Facade 类写错了，而是自动加载或别名没配对。Laravel 会缓存 config/app.php 里的 aliases，改完不清理就白搭。
- 检查
composer.json的autoload["psr-4"]是否包含"App\Facades\": "app/Facades/"（默认 Laravel 已配，但移动目录后容易漏） - 确认
config/app.php的'aliases'数组里加了这一行：'Sms' => AppFacadesSms::class - 改完配置后必须运行
php artisan config:clear，否则旧缓存还在，IDE 和运行时都看不到新别名 - 别名首字母大写（
'Sms'），但 Facade 类文件名和类名也得匹配 ——app/Facades/Sms.php里必须是class Sms extends Facade
Facade 调用时方法不存在，问题出在哪？
不是 Facade 类缺方法，而是它代理的那个容器实例本身没这个方法，或者代理错了对象。
- 先确认目标服务类（如
SmsService）里真有你要调用的send()方法，且是public - 再检查
getFacadeAccessor()返回的键，是否和容器绑定的键完全一致 —— 这是最常被忽略的「隐形断点」 - 如果服务类依赖其他对象（比如需要
HttpClient），确保构造函数能被容器正确解析；否则app('sms.service')会抛异常，Facade 调用也会失败 - 别试图给 Facade 类加方法 —— 它只是壳，所有逻辑必须落在服务类里
最麻烦的不是步骤多，而是三处键名必须一字不差地咬合：服务提供者 bind 的键、Facade 类的 getFacadeAccessor() 返回值、config/app.php aliases 里的 key。少一个字符，整个链就断了。
