facade调用带参方法必须通过静态代理实现，不能直接传参；需在facade子类中显式声明方法或启用__callstatic动态转发，并确保容器已绑定对应实例。
Facade 调用带参数的方法必须走静态代理，不能直接传参
ThinkPHP 的 Facade 本质是静态代理，它把调用转发给容器中绑定的实例。但很多人误以为可以像普通静态方法那样直接写 Cache::get('key', 'default') —— 这在大多数版本里会报错或返回空，因为默认的 Facade 类没定义该静态方法，也未启用动态方法代理。
真正能用的前提是：目标类方法已在 Facade 子类中显式声明（通过 __callStatic 或提前定义），或者你用的是 ThinkPHP 6.1+ 并开启了「自动代理」（需手动配置）。
- ThinkPHP 6.0 默认不支持未声明方法的静态调用，
Cache::get()之所以能用，是因为thinkFacadeCache类里已重写了get方法并做了转发 - 如果你自定义了一个服务类
AppServicePayment，并创建了对应的 FacadeAppFacadePayment，但没在其中定义pay()方法，那么Payment::pay($order)会触发 PHP 致命错误：Call to undefined method AppFacadePayment::pay() - 想让任意方法都可被 Facade 静态调用，得在自定义 Facade 类中启用
__callStatic并手动转发，且确保容器已绑定对应实例
手动实现带参 Facade 调用的最小可行写法
以 AppServiceLogger 为例，它有个带参数的 log($level, $message, $context = []) 方法。要通过 Logger::log('error', 'timeout') 调用，必须这样写 Facade 子类：
namespace AppFacade;
use thinkFacade;
class Logger extends Facade
{
protected static function getFacadeClass()
{
return 'app\service\Logger';
}
// 必须显式声明，否则无法透传参数
public static function log($level, $message, $context = [])
{
return static::make()->log($level, $message, $context);
}
}
注意：static::make() 返回的是容器解析出的真实实例，后续所有参数都原样传给它的 log() 方法。别漏掉 $context = [] 这样的默认值，否则调用时少传参数会报 Warning。
TP6.1+ 可开启自动代理，但有严格前提
从 ThinkPHP 6.1 开始，Facade 基类支持 __callStatic 动态转发，但不是默认开启——你需要在自定义 Facade 类中主动启用：
- 继承
thinkFacade后，必须覆写__callStatic方法，并调用父类的__callStatic（它内部会查容器、转发） - 同时确保
getFacadeClass()返回的类名能被容器正确解析（比如已通过bind()或singleton()绑定） - 参数完全透传，无需手动列参数，但方法签名必须和真实类一致，否则 PHP 会因参数数量不匹配而报错
示例：
class Logger extends Facade
{
protected static function getFacadeClass()
{
return AppServiceLogger::class;
}
public static function __callStatic($method, $params)
{
return parent::__callStatic($method, $params);
}
}
这样写完后，Logger::log('info', 'start') 就能通了。但要注意：如果真实类的 log() 方法用了 PHP 8 的命名参数或类型约束，Facade 层不会做任何校验或转换，出错就直接抛给调用方。
常见报错和绕过方式
遇到 Call to undefined method xxx::yyy() 时，先确认三件事：
- 对应 Facade 类是否已声明该方法（或启用了
__callStatic） - 容器中是否已绑定该服务类（例如在
app/provider.php里加了AppServiceLogger::class） - 是否混淆了 Facade 和门面别名 —— 比如你在
config/app.php中配了'logger' => AppFacadeLogger::class，那应该用think acadeLogger，而不是logger（小写）来调用
实在不想写 Facade 子类？可以直接从容器取实例：app('app\service\Logger')->log('warn', 'slow')，语义清晰、无代理开销，适合临时或复杂参数场景。
Facade 的参数透传看着简单，实际卡点都在类绑定时机、方法声明完整性和容器解析路径上，漏一个就挂。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
