安全绑定时机仅限app/bootstrap.php末尾或命令handle()开头；bind()每次新建实例，应优先用singleton()；换缓存驱动须通过config/cache.php配置而非手动绑定；Swoole中绑定后需调用setInstances([])清空实例缓存。
直接用 Container::getInstance()->bind() 绑定会失效
在非应用上下文（比如 common.php、命令行脚本开头、或 Swoole Worker 进程里）调用 bind()，极大概率被后续框架初始化覆盖。官方明确禁止在 common.php 中绑定，因为此时容器尚未完成核心类注册，bind() 写入的映射会被后续 App 实例的初始化流程冲掉。
真正安全的绑定时机只有两个：
-
app/bootstrap.php文件末尾 —— 此时容器已初始化，但应用尚未启动，适合全局固定绑定（如自定义缓存驱动） - 自定义命令的
handle()方法开头 —— 仅对当前命令生效，适合临时替换（如测试用 Mock 缓存）
bind() 和 singleton() 的区别必须分清
缓存类通常需要单例行为（比如 Redis 连接复用），但 bind() 默认每次调用 get() 都新建实例（除非你传闭包并自行控制），而 singleton() 才是真正保证“首次创建、后续复用”的方法。
常见错误写法：Container::getInstance()->bind('cache', \think\cache\driver\Redis::class) → 每次 app('cache') 都 new 一个新 Redis 实例，连接数暴涨。
立即学习“PHP免费学习笔记（深入）”；
正确做法应优先用 singleton()：
Container::getInstance()->singleton('cache_adapter', function () {
return new \think\cache\driver\Redis([
'host' => '127.0.0.1',
'port' => 6379,
'password' => '',
'select' => 0,
]);
});
或者更推荐：走标准配置驱动机制，而非手动绑定缓存类本身（见下一条）。
绑定缓存类 ≠ 替换缓存驱动，别绕过 Cache 配置体系
ThinkPHP 的 Cache::get() / Cache::set() 底层不直连你绑定的类，而是通过 cache.driver 配置 + Cache 门面代理。手动绑定 'cache' 标识反而可能破坏门面逻辑。
想换缓存实现，应该：
- 在
config/cache.php中设'default' => 'redis'，并配好'redis'驱动参数 - 若需自定义驱动类（比如加日志埋点的 Redis 包装器），继承
\think\cache\driver\Redis，再在配置中指定'redis' => ['type' => \app\cache\TracedRedis::class] - 仅当必须注入运行时变量（如动态 DB 名）才考虑
singleton()绑定，并确保不与Cache门面冲突
Swoole 环境下绑定后必须重置容器实例缓存
在 Swoole Worker 中反复绑定又不清理，会导致内存持续增长。因为 bind() 只写入 $bind 数组，但之前 get() 过的实例仍留在 $instances 中，不会自动释放。
若必须在 Worker 中动态绑定（如按租户切换缓存实例），务必同步清理：
$container = Container::getInstance();
$container->bind('tenant_cache', $tenantRedisInstance);
// 关键：清空已缓存的实例，否则下次 get 仍返回旧对象
$container->setInstances([]);
注意：$container->forget('tenant_cache') 只删绑定定义，不删已创建实例 —— 这个细节几乎所有人第一次都踩坑。
