门面不是静态工具类，调用失败基本是因为容器没绑对、键名不一致或别名没注册——三者缺一不可。
门面调用报 Class not found 或 Method does not exist 怎么查
这类错误几乎都出在配置链断裂上，不是代码写错，而是某环没接上：
-
Class 'MyService' not found：检查config/app.php的'aliases'数组是否加了'MyService' => \App\Facades\MyServiceFacade::class，加完必须运行php artisan config:clear -
Target [my.service] is not instantiable：说明容器里没绑my.service这个键，去AppServiceProvider@register()确认$this->app->singleton('my.service', ...)是否存在，且拼写完全一致（大小写、空格都不能差） -
Method MyServiceFacade::doSomething() does not exist：实际是底层服务类（比如\App\Services\MyService）里没有doSomething()方法，或者门面的getFacadeAccessor()返回了错误键名，导致拉出了别的实例
Laravel 9+ 自定义门面必须用 $facadeAccessor 静态属性
旧版用 getFacadeAccessor() 方法，新版 Laravel（9 及以后）已弃用该方法，强制改用静态属性，否则 __callStatic 根本找不到绑定键：
namespace App\Facades;
<p>use Illuminate\Support\Facades\Facade;</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill7885" title="laravel-specialist"><img
src="https://img.php.cn/upload/skill/000/000/081/179172020840450.jpg" alt="laravel-specialist" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill7885" title="laravel-specialist">laravel-specialist</a>
<p>精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...</p>
</div>
<a href="/xiazai/skill7885" title="laravel-specialist" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p>class MyServiceFacade extends Facade
{
protected static $facadeAccessor = 'my.service';
}
如果仍写 getFacadeAccessor()，会直接触发基类 fallback 行为，最终解析失败。Laravel 10 官方文档也只列这个写法。
别在构造函数里 type-hint 门面类
门面类不能被依赖注入，它不是服务对象，只是代理壳：
- 错误写法：
public function __construct(\App\Facades\MyServiceFacade $service)→ 报Target class [\App\Facades\MyServiceFacade] is not instantiable - 正确做法：要么用
app('my.service')手动取，要么注入真实服务类\App\Services\MyService，或者用接口契约 + 容器绑定 - 测试时更明显：你 mock 不了
MyServiceFacade::xxx()，但可以 mock 容器里它实际解析的那个实例
DB 门面能执行原生 SQL，但不能当 QueryBuilder 实例用
DB::select() 看似简单，背后是完整生命周期管理；手动 new 一个 QueryBuilder 会立刻崩：
-
DB::select('SELECT * FROM users WHERE id = ?', [1])→ 正常，连接已初始化、grammar 已设置、事件 pipeline 已挂载 -
new \Illuminate\Database\Query\Builder(...)→Call to a member function connection() on null，因为没设connection、没走DatabaseManager的构建逻辑 - 想绕过门面调试？至少补上：
$builder->setConnection($connection)->useTable('users')，否则连基础方法都调不动
最常被忽略的是：门面的键名一致性必须贯穿容器绑定、getFacadeAccessor（或 $facadeAccessor）、别名注册三处，漏掉任一环节或错一个字符，就全链路失效。
