Facade 是 Laravel 提供的静态接口包装机制，用于以静态方式访问容器中绑定的实例；它不是别名、代理加载器或设计模式门面，不实现逻辑，仅转发调用到容器实例。
Facade 是什么，不是什么
Facade 不是别名，也不是代理类的自动加载器；它是 Laravel 提供的一套静态接口包装机制，用来以静态方式访问容器中绑定的实例。你写 Cache::get('key')，背后实际调用的是容器里 cache 这个绑定项的 get() 方法。
常见错误现象：Class 'App\Http\Controllers\Cache' not found —— 通常是因为没加 use Illuminate\Support\Facades\Cache;，或者用了 Cache 但没在 config/app.php 的 'aliases' 里注册（Laravel 10+ 默认已注册）。
- 必须确保对应 Facade 类已在
config/app.php的'aliases'数组中声明（如'Cache' => Illuminate\Support\Facades\Cache::class） - Facade 类本身不实现逻辑，只负责从容器取实例并转发调用，所以不能靠它查方法签名，得看它指向的真实类（比如
Cache指向Illuminate\Cache\Repository） - Laravel 10 起默认禁用全局辅助函数（如
cache()），若想用 Facade 就老老实实use，别指望自动识别
怎么自定义一个 Facade
自定义 Facade 的核心就三步：写服务类 → 绑定到容器 → 写 Facade 类并注册别名。它不是语法糖，而是明确把“容器绑定名”和“静态调用名”解耦的设计。
使用场景：封装第三方 SDK、统一内部工具类调用入口（比如公司内部的 Pay::refund()）、隔离底层实现变更。
- 服务类（如
App\Services\AliyunOss）要能被容器解析，推荐通过bind或singleton注册，键名就是 Facade 中getFacadeAccessor()返回的字符串 - Facade 类必须继承
Illuminate\Support\Facades\Facade，且重写getFacadeAccessor()，返回容器绑定名（如'aliyun.oss'） - 别名注册后，
use App\Facades\AliyunOss;才能让AliyunOss::upload()工作；漏掉use或拼错类名，会直接报Class not found
Facade 和依赖注入比，差在哪
Facade 看起来方便，但破坏了可测试性和依赖显式性。它隐式依赖容器状态，而 DI 把依赖写在构造函数或方法参数里，一目了然。
性能影响几乎可忽略（一次容器解析 + 静态方法调用），但兼容性风险明显：比如你在测试中 mock 了容器里的 cache 实例，但 Facade 调用仍可能绕过 mock，因为 Facade 用的是容器当前状态，不是你手动传入的对象。
- 单元测试时，
Cache::shouldReceive(...)这种 Mock 方式在较新版本（如 Laravel 10+）已失效，得改用Cache::swap(new FakeCache)或直接注入Repository接口 - IDE 自动补全对 Facade 支持弱，尤其自定义 Facade，基本没提示；而类型提示 + DI 能让 PHPStorm 精准跳转到方法定义
- 多人协作时，看到
Log::error()不知道它来自哪个具体实现类，除非去查getFacadeAccessor()，而LoggerInterface $log一眼可知契约
什么时候不该用 Facade
当逻辑需要明确生命周期控制、多实例隔离、或涉及上下文切换时，Facade 就不合适。比如不同租户要用不同数据库连接配置的 Redis 客户端，用 Redis::get() 就没法指定连接池，只能切回 RedisManager 实例。
容易踩的坑：在命令行或队列任务里误以为 Facade 总是“单例”，其实它每次调用都重新从容器取实例（取决于绑定方式），如果绑的是 bind（非 singleton），那每次都是新对象 —— 这会导致缓存、连接等状态无法复用。
- 不要在循环里高频调用 Facade 做 I/O 操作（如
DB::table()->where(...)->first()），应先注入Builder或用查询构造器变量缓存 - 避免在中间件或服务提供者启动阶段使用 Facade，此时容器可能未完全启动（如
AppServiceProvider的register()方法里用Config::get()可能返回空） - 升级 Laravel 版本时，注意 Facade 对应的真实类是否废弃（例如
ValidatorFacade 在 9.x 后不再推荐，应改用ValidatorFactory）
Facade 最容易被忽略的点：它本质是“语法便利 + 容器快捷键”，不是设计模式意义上的门面。真要解耦，该用接口+契约；真要简化，优先考虑辅助函数或更细粒度的 Service 类。别为了“看起来像 Laravel 风格”而硬套 Facade。
