Facade调用Service前必须确保Service已注册进容器，正确做法是通过Facade::bind()或服务提供者绑定标识符，且Service类需符合命名空间、自动加载及方法可见性要求。
Facade 调用 Service 前必须确保 Service 已注册进容器
直接在 getFacadeClass() 里返回 UserService::class 是无效的，除非该类已通过容器绑定或能被自动解析（比如无参构造、所有依赖可反射注入）。否则会抛出 InvalidArgumentException: Identifier "appserviceUserService" is not registered。
正确路径是：先让 Service 可被容器识别，再让 Facade 指向它。关键不在 Facade 类本身，而在容器注册环节。
- Service 类必须放在
app/service/下，且命名空间声明为appservice - 在
composer.json的"autoload" → "psr-4"中添加："app\service\": "app/service/" - 执行
composer dump-autoload（漏这步，use appserviceUserService就会报错） - Service 不能靠
new或app()->make()临时调用——必须通过服务提供者或容器绑定显式注册
Facade::bind() 是最直接的绑定方式
如果你不想写完整的服务提供者，又想让 Facade 静态调用指向某个 Service 实例，Facade::bind() 是最快捷的入口。它绕过容器自动解析逻辑，直接建立字符串标识符到类的映射。
例如，要让 UserFacade::create() 调用 UserService::create()：
立即学习“PHP免费学习笔记（深入）”；
use thinkFacade;
use appserviceUserService;
Facade::bind('user', UserService::class);
然后在 app acadeUser.php 中写：
namespace app acade;
use thinkFacade;
class User extends Facade
{
protected static function getFacadeClass()
{
return 'user';
}
}
此时 User::create() 就等价于 app()->get('user')->create()，而 app()->get('user') 返回的就是 UserService 实例。
-
Facade::bind()必须在应用启动早期执行，推荐放在app/common.php或服务提供者的register()方法中 - 不要在控制器或中间件里重复调用，它只生效一次
- 若 Service 构造函数有依赖（如
private CacheInterface $cache），Facade::bind()仍能工作，因为容器会自动解析构造参数
用 ServiceProvider 绑定更规范，适合团队项目
当 Service 有复杂初始化逻辑（比如需读配置、连接外部服务），或需要控制生命周期（单例 vs 每次新建），应改用服务提供者。Facade 只负责“指路”，真正“修路”的是 register() 里的绑定动作。
例如，在 app/provider/UserServiceProvider.php 中：
namespace appprovider;
use thinkService;
use appserviceUserService;
class UserServiceProvider extends Service
{
public function register()
{
$this->app->singleton('user_service', UserService::class);
// 或带闭包初始化：
// $this->app->singleton('user_service', function ($app) {
// return new UserService($app->make(CacheInterface::class));
// });
}
}
然后在 app acadeUser.php 的 getFacadeClass() 返回 'user_service'，而非类名。
- 别忘了在
config/app.php的'providers'数组中加入appproviderUserServiceProvider::class - TP8 不会自动扫描 providers，不手动加就等于没注册
- 绑定标识符（如
'user_service'）必须和getFacadeClass()返回值完全一致，大小写敏感
为什么 Facade 调用时提示方法不存在？
常见错误不是 Facade 写错了，而是目标 Service 类里真没定义那个方法，或者方法是 private / protected。Facade 的 __callStatic() 代理的是实例方法调用，对可见性有严格要求。
比如你在 UserService 里写了：
private function create(): bool { ... } // ❌ Facade 调用失败
public function create(): bool { ... } // ✅ 正常代理
另外注意：如果 Service 方法签名含类型提示（如 public function create(UserDTO $dto)），调用方传参必须满足类型约束，否则 PHP 会直接报致命错误，不会走到 Facade 层。
- Facade 不做参数转换，也不拦截异常——它只是个透明通道
- 别在 Service 方法里 throw 新异常类型却不声明，否则 Facade 调用时可能因类型不匹配中断
- 最易忽略的一点：Service 默认是单例，但若构造函数注入了请求上下文对象（如
Request），多个请求共享实例会导致状态污染；这时应改用$this->app->bind()替代singleton()
