门面是容器代理层而非语法糖；必须继承thinkFacade并实现getFacadeClass()返回完整命名空间或已绑定名，方法需public且存在于真实类中，路径命名须符合PSR-4，调用前确保容器已启动、绑定已注册、自动加载就绪。
门面不是语法糖，是容器代理层；直接写 Cache::get() 能跑，不代表它背后没走容器解析、没依赖绑定关系。
门面类必须继承 thinkFacade 且重写 getFacadeClass()
这是最常漏掉的一环：光建了 app acadeTest.php 文件，但没继承基类或没返回真实类名，调用时会报 BadMethodCallException 或直接 Fatal error。
-
getFacadeClass()返回值必须是完整命名空间字符串，比如'appcommonTestService'，不能是别名或短名 - 返回值可以是容器绑定名（如
'test_service'），但前提是该名已在容器中通过$app->bind('test_service', TestService::class)显式注册 - 若返回的是类名，该类必须可被自动加载；若返回的是绑定名，绑定必须发生在门面调用前（通常在服务提供者
register()中） - 调试时可在
getFacadeClass()末尾加var_dump(static::getFacadeClass()); exit;确认返回值是否符合预期
调用时方法必须存在于真实类中，且不能是 private/protected
门面不改写访问控制 —— 它只是把 Test::doSomething() 转发给容器解析出的实例的 ->doSomething()。如果真实类里这个方法是 private，就会抛出不可访问异常。
- 确保真实类中被调用的方法是
public，且签名与门面调用一致（参数数量、类型提示等） - 不要在门面类自身定义同名方法（如在
app acadeTest里写一个public static function doSomething()），这会绕过容器解析，导致依赖未注入、单例失效等问题 - 若真实类方法带类型提示（如
public function handle(Request $request)），容器会自动注入，但前提是Request类本身也已注册或可自动解析
自定义门面必须确保类路径和命名空间匹配自动加载规则
ThinkPHP 默认按 PSR-4 加载，app acadeTest 对应文件路径必须是 app/facade/Test.php，少一个字母、大小写错、目录名拼错（比如写成 Facade 而非 facade），都会导致类找不到。
立即学习“PHP免费学习笔记（深入）”；
- 检查
composer.json中的 autoload 配置，确认"app\"映射到"app/"目录 - 执行
composer dump-autoload刷新自动加载映射（尤其在新增门面类后） - Windows 下注意大小写不敏感但 Linux 敏感，开发环境用 Linux 容器或 WSL 可提前暴露路径问题
- 不建议把门面类放在
common或service目录下——门面必须在app acade命名空间下，否则框架无法识别为合法门面
不要用门面调用构造函数有强依赖或需手动初始化的类
门面背后是容器解析，而容器默认只对构造函数参数做自动注入。如果某个类的构造函数需要传入无法由容器自动提供的参数（比如一个运行时计算的 token、一个闭包、一个资源句柄），那它就不适合用门面静态调用。
- 这类类更适合手动 new + 依赖注入，或封装进工厂方法，再由门面调用工厂
- 例如
new PaymentClient($config, $logger)中的$config是动态读取的数组，就不能靠容器自动 resolve，强行用门面会导致ReflectionException - 门面适合「开箱即用」的服务类（缓存、日志、数据库），不适合「每次都要定制初始化」的工具类
真正容易被忽略的，是门面调用的时机 —— 它依赖容器已启动、绑定已注册、自动加载已就绪。任何一步在请求生命周期早期失败，都不会报明确错误，而是静默 fallback 到类未找到或方法不存在。所以第一次写自定义门面，别急着在控制器里调，先在命令行执行 php think run 启动交互模式，手动 use app acadeTest; Test::hello(); 测试，能过再集成进 HTTP 请求链路。
