extend() 是 manager 类的方法而非 container 的，必须在 boot() 中通过 $this->app['cache']->extend() 调用，闭包需返回 repository 实例且 store 必须实现 cache\store 接口。
extend() 方法不是给服务容器用的，是给管理器（Manager）用的
很多人卡在“app()->extend() 不存在”或“$this->app->extend() 报错”，根本原因是搞错了调用对象。Laravel 的 extend() 是 Manager 类的方法，不是 Container 本身的。比如 CacheManager、AuthManager、QueueManager 都有这个方法；但 Container 没有。
所以你不能写：$this->app->extend('cache', ...) —— 这会直接抛 BadMethodCallException。
正确路径是：先拿到对应管理器实例，再调用它的 extend()：
$this->app['cache']->extend('mongo', function ($app) {
return new \Illuminate\Cache\Repository(
new MongoStore($app['config']['cache.stores.mongo'])
);
});
注意三点：
-
$this->app['cache']返回的是CacheManager实例，不是Repository - 闭包必须返回一个
Illuminate\Cache\Repository实例，不能只返回Store - 扩展名（如
'mongo'）要和config/cache.php中的driver值一致，否则配置不生效
为什么 extend() 必须在 boot() 里调用
因为 Manager 实例是在 boot() 阶段才被绑定进容器的。如果在 register() 里调用 $this->app['cache']->extend(...)，会触发懒加载，而此时 CacheManager 的构造依赖（如 config、events）可能还没注册完，导致 ReflectionException 或 Target is not instantiable。
常见错误现象：
- 本地开发正常，队列任务里报
Call to a member function extend() on null - Artisan 命令中执行失败，提示
cache键未找到 - 扩展后 config/cache.php 切换 driver 无效，始终走默认驱动
解决方案：所有 extend() 调用必须放在 AppServiceProvider::boot() 中，且确保该服务提供者已启用（检查 config/app.php 的 providers 数组）。
extend() 闭包里不能直接 new 有依赖的对象
闭包里看似自由，实则受限。比如你想扩展一个带数据库连接的缓存 Store，别这么写：
$this->app['cache']->extend('mysql', function ($app) {
return new MysqlStore(new PDO(...)); // ❌ 错误：绕过容器，PDO 未注入
});
这会导致两个问题：
- PDO 实例没走容器，无法被 Mock，单元测试彻底失效
- 连接未复用，每次缓存操作都新建 PDO，连接池迅速打满
正确做法是通过 $app->make() 获取受管实例：
$this->app['cache']->extend('mysql', function ($app) {
return new MysqlStore($app->make('db.connection'));
});
注意：$app->make('db.connection') 是单例，而 $app->make(\PDO::class) 可能不是——取决于你是否对 PDO 显式绑定了 singleton()。
扩展后 driver 不生效？检查三个硬性条件
即使 extend() 执行成功，config/cache.php 里设了 'driver' => 'mongo'，仍可能 fallback 到 file。原因通常是以下任一条件未满足：
- 扩展名（
'mongo'）和配置中的driver值大小写/拼写完全一致（Laravel 区分大小写） -
CacheManager尚未完成初始化就调用了extend()（再次强调：只能在boot()） - 自定义 Store 类没实现
Illuminate\Contracts\Cache\Store接口，导致Repository构造时类型检查失败
最容易被忽略的是第三点：接口契约不是可选的。哪怕你只是想加个日志，也得继承 ArrayStore 或完整实现全部方法，否则 Repository 构造时会因类型不匹配而静默降级。
