门面调用失败主因是use语句错误或配置未生效；db门面类名必须小写d，需检查命名空间、大小写、app_facade配置、数据库连接及中间件中容器初始化时机。
门面调用失败，90% 以上是 use 语句写错或配置未生效，不是框架坏了。
Db 门面报 “Class not found” 怎么办
最常见的是大小写错误和命名空间拼写问题。ThinkPHP 的门面类名是 Db（小写 d），不是 DB 或 db。PHP 在类名上大小写敏感，尤其在 Linux 服务器上会直接报错。
- 错误写法：
use think\facade\DB;→ 类找不到 - 正确写法：
use think\facade\Db; - 如果不想用
use，可直接用完全限定名：\think\facade\Db::table('user')->select(); - 检查是否在
config/app.php中启用了门面：确认'app_facade' => true已开启（TP6 默认开启，但自定义部署可能关掉）
自定义门面为什么始终调不到方法
自定义门面必须绑定到一个「真实类」，且该类需满足：有对应方法、方法是 public、不能是静态方法（除非你显式声明为 static）。
- 门面类里
getFacadeClass()返回的类路径必须能被自动加载，比如app\common\service\UserService对应文件app/common/service/UserService.php - 不要把方法写成
public function test() { ... }却在门面里试图用Db::test()—— 这是错的，Db是固定门面，不支持动态绑定任意类 - 若要调用
UserService，应新建门面app\facade\UserService，并在getFacadeClass()中返回app\common\service\UserService::class - 别在控制器里直接 new 一个门面类，门面不是普通对象，它靠容器代理调用
门面调用后 SQL 不执行或报连接失败
这说明门面虽然加载成功，但底层数据库服务没起来。门面只是“外观”，真正干活的是 think\db\Connection 实例。
- 检查
config/database.php是否存在且可读，重点看'default'配置项是否指向已定义的连接器（如mysql） - 确认
'hostname'、'username'、'password'、'database'四项都填了，空字符串或 null 会导致连接拒绝 - 运行
php think run启动内置服务器时，注意控制台是否输出[Database] Connected to mysql://...；没有则说明配置未加载 - 如果用了环境变量（如
env('DB_HOST')），确认.env文件存在且未被 gitignore 忽略，且变量值不含多余空格或换行
为什么 Auth 或 Cache 门面在中间件里用不了
门面依赖容器实例，而某些中间件（尤其是前置中间件）执行时容器可能尚未完全初始化，或当前请求上下文缺失关键服务。
-
Auth门面默认使用session驱动，在无 session 的 API 场景中会静默失败；改用Auth::guard('api')并确保config/auth.php中guards.api配置完整 -
Cache门面若报Driver not supported，检查config/cache.php中'default'对应的驱动（如redis）是否已安装扩展，且extension=redis在 php.ini 中启用 - 避免在
__construct()中调用门面，应移到handle()方法内 —— 构造函数执行时容器可能还没注入 - 调试时可在中间件开头加一行：
dump(\think\Container::getInstance()->has('cache'));确认服务是否已注册
门面不是语法糖，它是容器 + 代理 + 延迟绑定的组合体。出问题时别急着重写逻辑，先确认容器有没有、服务有没有、门面类名对不对——这三个点卡住，后面全白搭。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
