根本原因是 getInstance() 返回 null 后直接调用实例方法，常见于手动销毁未重置静态属性、CLI 下初始化失败或容器与手写单例冲突；应优先使用 Container::get()、避免析构函数清理、禁止单例持有请求/DB 等有状态对象。
ThinkPHP 单例类报 Call to a member function on null
根本原因是 getInstance() 返回了 null，而后续代码直接调用了实例方法。常见于手动销毁后未重置静态属性，或在 CLI 模式下跨请求复用单例但初始化失败。
实操建议：
- 检查单例类的
getInstance()是否有早期return null分支（比如配置未加载完就返回） - 确认构造函数中是否抛出了异常但被静默吞掉（如
try/catch里只Log::error()却没 throw） - CLI 命令中慎用
static $instance：PHP-FPM 进程结束即回收，但 CLI 脚本生命周期长，若某次初始化失败，$instance就永远卡在null
ThinkPHP 的 Container::get() 和手写单例冲突
TP6+ 默认容器已接管单例管理，自己再写 private static $instance + getInstance() 容易和容器注册逻辑打架——尤其是当类被 bind() 或 singleton() 注册过时，两次获取可能拿到不同实例或触发重复初始化。
实操建议：
- 优先用容器：在
app/provider.php中写App\Logic\UserService::class => \think\Container::getInstance()->singleton(App\Logic\UserService::class) - 若必须手写单例，确保构造函数无副作用，且不依赖容器自动注入（否则
new static()会绕过依赖解析） - 避免在单例内部又调用
Container::get()获取自身，容易引发循环依赖，报错Maximum function nesting level reached
__destruct() 里 unset 静态实例不生效
PHP 析构函数无法安全清理 static $instance，因为对象销毁时机不可控，且静态变量属于类作用域而非对象，unset(self::$instance) 在 __destruct() 中执行后，下次 getInstance() 仍可能返回旧引用（尤其在 Swoole 长连接场景下）。
实操建议：
- 不要依赖
__destruct()清理单例，它在 CLI 或 FPM 下行为不一致 - 需要重置时，显式调用
resetInstance()类方法（手动置self::$instance = null） - Swoole 环境下，在
onWorkerStart或onRequest开头主动重置关键单例，防止上一请求残留状态污染
内存泄漏：单例持有 Request/Response/Db 对象
单例如果在构造时存了 Request、Response 或查询构建器（如 Db::name('user')），这些对象会携带整个请求上下文或 PDO 连接，导致内存无法释放，FPM 下表现为 RSS 持续上涨。
实操建议：
- 单例中只保存无状态的工具类或配置数据，避免持有可能带生命周期的对象
- 必须访问请求数据时，改用
input()、config()等无状态函数，而不是存$this->request - 数据库操作应每次按需获取
Db实例，不要在单例构造里做$this->db = Db::name('log')
事情说清了就结束。单例最难缠的不是写法，是它把“一次初始化”和“长期存活”的预期，悄悄塞进了你本以为只是“省个 new”的地方。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
