Facade必须先将类注册进容器再代理，否则因Container::make()无法解析未注册标识而报错；正确步骤为：加载类、bind注册服务、Facade类中getFacadeClass()返回对应标识符。
Facade 不能直接给任意第三方类库加静态入口，必须先让类进容器，再配 Facade 类代理 —— 否则 Class not found 或 Identifier "xxx" is not registered 是必然结果。
为什么 require_once 后的类不能直接 Facade？
Facade 的 __callStatic 最终靠 Container::make() 实例化目标类。而 make() 只能解析容器里已注册的服务（类、闭包、实例或绑定标识符）。单纯 require_once 第三方 SDK（比如 extend/aipbaidusdk/AipNlp.php）只是加载了类定义，没注册进容器，getFacadeClass() 返回的字符串对不上任何容器标识，createFacade() 就会抛出 InvalidArgumentException。
- 常见现象：调用
AipNlp::xxx()报错Identifier "aipnlp" is not registered，不是类没加载，是容器不认识它 - 第三方类通常没有构造依赖声明（如
__construct($appId, $apiKey, $secretKey)），必须手动绑定参数，否则make()无法自动注入 - 不推荐在
getFacadeClass()中返回完整类名字符串（如'AipNlp'），因为容器默认不认裸类名，除非你额外用bind('AipNlp', AipNlp::class)显式注册
正确做法：三步走，缺一不可
以百度 AIP NLP SDK（extend/aipbaidusdk/AipNlp.php）为例：
- 第一步：确保类已加载 —— 在
app/common.php或服务提供者中require_once EXTEND_PATH . 'aipbaidusdk/AipNlp.php'; - 第二步：向容器注册服务 —— 在
app/provider.php或app/bootstrap.php中写：Container::getInstance()->bind('aipnlp', function () {<br> return new \AipNlp('your_app_id', 'your_api_key', 'your_secret_key');<br>}); - 第三步：创建 Facade 类 —— 新建
app/facade/AipNlp.php，内容为：namespace app\facade;<br>use think\Facade;<br>class AipNlp extends Facade<br>{<br> protected static function getFacadeClass()<br> {<br> return 'aipnlp'; // 必须和 bind() 的第一个参数完全一致<br> }<br>}
常见坑：别在 Facade 类里硬写 new 实例
有人图省事，在 getFacadeClass() 里直接 return new \AipNlp(...)，这是错的 —— getFacadeClass() 只接受字符串（容器标识符）或数组（[类名, 参数]），返回对象会触发类型错误；更严重的是，这样每次调用都会新建实例，失去单例控制，且绕过容器生命周期管理。
立即学习“PHP免费学习笔记（深入）”；
- 错误写法：
return new \AipNlp(...)→ PHP Fatal error: Class name must be a valid object or a string - 也别写
return \AipNlp::class→ 容器找不到该类的绑定，报Identifier "AipNlp" is not registered - 如果 SDK 构造函数依赖配置项，建议从
config('aip.nlp')读取，而不是写死在bind()闭包里，方便多环境切换
验证是否成功：一个命令就够了
在控制器里写一行：dump(app('aipnlp'));。如果输出的是 \AipNlp 实例，说明容器注册成功；再试 app\facade\AipNlp::xxx()，能正常调用就代表 Facade 链路通了。
最易被忽略的一点：Facade 类名（app\facade\AipNlp）和容器标识符（'aipnlp'）是两回事，前者是调用入口，后者是容器钥匙，二者命名可以不同，但必须在 getFacadeClass() 里精确对应 —— 错一个字母、大小写不对、多空格，都会断链。
