app::make() 默认每次返回新实例,除非显式注册为单例或已缓存;常见问题包括绑定被覆盖、swoole下实例未重置、控制器未走容器注入、类名错误导致反射失败。

App::make() 返回新实例而不是复用单例?先查绑定是否被覆盖
ThinkPHP 容器默认不自动共享实例,App::make('MyService') 每次都新建对象,除非你显式声明为单例或已缓存。但更常见的情况是:你以为绑定了单例,结果被后续的 bind() 覆盖了——尤其在多个服务提供者、中间件或测试 setUp 中混用 bind() 和 singleton() 时。
验证方法很简单:dd(app()->getBindings()['MyService::class'] ?? null)。如果看到 'shared' => false,说明当前绑定不是单例;如果压根没这个 key,说明类根本没注册进容器。
- 别在不同 provider 的
register()方法里重复bind(MyService::class, ...)—— 后加载的会直接干掉前一个 - 用
singleton()替代bind()注册需要复用的类,它等价于bind(..., ..., ['shared' => true]) - 如果必须动态覆盖(比如测试中 mock),优先用
app()->instance(MyService::class, $mock),它跳过绑定逻辑,直接塞实例进缓存
用了 Swoole 长连接,每次请求都 new 出新容器?重置时机错了
在 Swoole 环境下,容器实例跨请求存活,但 $container->instances(已解析实例缓存)不会自动清空。如果你没手动重置,第二次请求调用 App::make('Db') 可能拿到的是第一次请求创建的、可能已失效的 PDO 连接。
关键点在于:$container->forget('Db') 只删绑定定义,不删已创建的实例;真正释放内存的是 $container->setInstances([])。
- 在 Swoole 的
onRequest或请求生命周期开始处执行Container::getInstance()->setInstances([]) - 保留核心绑定如
'app'、'think\Config',否则app('config')会报错 - 避免在重置后漏掉自定义服务提供者的
register(),否则下次make()会因未绑定而失败
控制器构造函数里 new 类,却以为走的是容器?根本没触发 DI
App::make() 正常返回单例,但你在控制器里写 new UserService(),那跟容器完全无关——它永远是全新实例,且绕过了所有绑定、依赖注入和生命周期管理。
更隐蔽的问题是:你以为控制器本身由容器创建(从而构造函数参数会被注入),但在 ThinkPHP 8 默认配置下,控制器仍是 new Index() 手动实例化的,__construct() 根本不经过容器。
- 不要在控制器构造函数里依赖类型提示,改用
initialize()方法做依赖获取 - 若坚持要用构造注入,需在路由定义中显式指定
['middleware' => [...]]并启用容器接管,或改用命令行模式下的App::invoke() - 检查
app()->resolved('app\controller\Index')是否返回true,否则说明该类从未被容器解析过
类名拼错、自动加载失效,导致每次 make 都 fallback 到反射 new?
App::make('app\service\UserService') 看似正确,但如果 class_exists('app\service\UserService') 返回 false,容器就会尝试用反射创建——而反射失败时可能静默返回 null,或抛出 ReflectionException: Class not found,让你误以为是“重复创建”,其实是“根本没创建成功”。
ThinkPHP 不会扫描目录自动注册类,一切依赖 Composer 自动加载和显式绑定。
- 运行
php think optimize:autoload强制刷新 autoload map - 在绑定前加一行
var_dump(class_exists('app\service\UserService')),确保输出bool(true) - 字符串别名绑定(如
bind('user_service', UserService::class))必须确保右侧是完整命名空间,不能省略\app\service\
app('request') 这类依赖全局状态的对象,必须在每次请求开始时重新 bind 或 instance,否则你会拿到上一次请求残留的 Request 实例——它里面的 input、header 全是旧的。php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











