Facade生效需同时满足：config/app.php中注册别名、getFacadeClass()返回容器已绑定的字符串标识符、服务提供者在register()中完成绑定、修改后清配置缓存。
provider.php 里注册的 Facade 类没被加载
TP6 的 provider.php 只负责注册服务提供者（Service Provider），不直接注册 Facade 别名。Facade 能不能用，和 provider.php 没有直接关系——它只管把服务绑定进容器，Facade 是另一套代理机制。
常见错误是：在 provider.php 里写了 App\Providers\MyServiceProvider::class，但忘了在 config/app.php 的 'aliases' 数组里加对应别名，结果代码里写 MyService::do() 就报 Class 'MyService' not found。
-
provider.php做的事：调用$this->app->bind('my_service', MyService::class)或类似逻辑，让容器知道怎么造实例 - Facades 要生效，必须同时满足两个条件：
getFacadeClass()返回的键（如'my_service'）已在容器中绑定，且该 Facade 类名已通过config/app.php的'aliases'显式注册 - 改完
provider.php后没清缓存，旧绑定仍生效；运行php artisan config:clear（TP6 兼容命令）或手动删runtime/cache/下配置缓存文件
Facade 类的 getFacadeClass() 返回值写错了
Facades 不是靠类名找服务，而是靠 getFacadeClass() 方法返回的字符串标识符去容器里查。写错这个返回值，就会静默失败——不报错，但调用时抛出 Identifier "xxx" is not registered。
比如你在 app/facades/MyServiceFacade.php 里写了：
立即学习“PHP免费学习笔记（深入）”；
protected static function getFacadeClass()
{
return \app\common\MyService::class;
}
这不对。容器里没有以完整类名为键的绑定，应该返回你在服务提供者里 bind() 用的那个键名：
protected static function getFacadeClass()
{
return 'my_service'; // 和 $this->app->bind('my_service', ...) 里的第一个参数完全一致
}
- 返回值必须是字符串，不能是类常量、
::class或带命名空间的类名（除非你明确在容器里用那个类名做了绑定） - 大小写敏感，
'MyService'和'myservice'是两个不同键 - 如果服务提供者里用的是
$this->app->singleton(MyService::class, ...)，那getFacadeClass()可以返回MyService::class，但前提是容器能自动解析该类（无参构造、依赖可推断）
服务提供者没真正执行 bind()，或者时机太晚
TP6 的服务提供者分 register() 和 boot() 两个阶段。register() 是唯一安全绑服务的地方；若在 boot() 里做 bind()，可能因依赖未就绪而失败，或者被后续覆盖。
典型误操作：
- 在
register()里写了$this->app->make('my_service')—— 这会触发实例化，但没绑定，Facade 查不到 - 在
boot()里调用$this->app->bind()—— 此时部分核心服务已启动，绑定可能被忽略或冲突 - 服务提供者类本身没被正确加载：检查
provider.php里写的类路径是否和文件物理位置一致（大小写、命名空间、文件名），TP6 不自动纠错
验证方式：在 register() 结尾加一行 dump($this->app->resolved('my_service'));，返回 false 说明根本没绑定成功。
Facade 类没被自动加载，或 use 写错了
即使 config/app.php 里写了 'MyService' => App\Facades\MyServiceFacade::class，如果 App\Facades\MyServiceFacade 这个类本身 PHP 找不到，还是会报 Class not found。
- 确认文件存在：
app/facades/MyServiceFacade.php，且命名空间确实是App\Facades - 确认类名和文件名一致：
MyServiceFacade.php里必须是class MyServiceFacade extends \think\Facade - 别在控制器或命令里写
use MyService;—— 这是别名，不是类名；正确写法是use MyService as MyService;或干脆不use，直接用全局别名调用 - 修改后必须清配置缓存，否则
config/app.php的'aliases'不会重载
Facade 生效链条很短：别名注册 → 类加载 → getFacadeClass() 返回有效键 → 容器存在该键绑定。任一环断开，就“看起来写了但没用”。最常被忽略的是别名注册和缓存清理这两步。
