Hyperf 中私有构造函数类需通过静态工厂方法注入：提供 public static make() 方法，在 dependencies.php 中绑定 ['MyClass' => [MyClass::class, 'make']] 或用 @Inject(MyClass::class . '::make')。
Hyperf 中无法直接 new 的类怎么注入
Hyperf 的 DI 容器默认只支持 public 构造函数，遇到
的类（比如单例、封装了复杂初始化逻辑的工具类），直接写在
或用
会报错：
。
这不是 Hyperf 的限制，而是 PHP 反射机制本身的约束——容器需要调用构造器，而私有构造器无法被外部调用。绕过它只有一条路：不用 new，改用静态工厂方法创建实例。
必须用静态工厂 + @Inject 注解配合
Hyperf 支持通过
绑定一个「可调用对象」，不一定是类名，也可以是带方法名的数组语法。前提是这个静态方法返回目标类的实例。
操作步骤如下：
Hyperf 3.1.66
本页面提供企业级 PHP 协程框架 Hyperf 3.1.66 版本的官方源码下载与完整更新日志。重点解析 v3.1.66 版本中新增的 gRPC 多客户端负载均衡支持、Pool 连接池全量刷新、Guzzle 持久化 Cookie 以及数据库 JSON 包含键查询等核心优化特性。
下载
确保目标类提供一个
（或类似命名，如
）
在依赖注入点（如 Controller 或 Service）用
，注意是字符串拼接，不是数组
在
中显式绑定（推荐）：
若该静态方法需要参数，Hyperf 会自动解析其类型提示（支持依赖注入），但不能有非可选标量参数
反射绕过构造器？别试，Hyperf 不认
有人想用
强行实例化，再手动调用
或 setter。这在纯 PHP 脚本里可能跑通，但在 Hyperf 容器中会失败：
容器内部对实例做类型校验、生命周期管理、AOP 织入时，都依赖标准构造流程
绕过构造器创建的对象，
、
、
等注解不会生效
Hyperf 的
在
阶段就抛出异常，根本不会走到反射实例化那步
即使 hack 成功，后续任何依赖该实例的其他服务注入都会出不可预测问题
工厂方法里要不要传参？看初始化逻辑是否依赖上下文
如果静态工厂方法需要运行时参数（比如根据请求头决定配置），就不能走容器自动解析，得手动调用工厂。此时注入应改为「注入工厂类本身」，而非最终实例：
把工厂抽成独立类（如
），实现
或
在目标类中
，然后在方法里调用
避免在构造器里硬编码参数，也别试图让容器“猜”你要传什么字符串
真正容易被忽略的是：私有构造器类往往还禁用了 clone 和反序列化，一旦你用反射强行绕过，
或 Swoole 进程复用时会直接崩溃。
private __construct()$dependencies@InjectCannot instantiate class xxx because constructor is private@Injectpublic static function make(): selfgetInstance()@Inject(MyClass::class . '::make')config/autoload/dependencies.php'MyClass' => [MyClass::class, 'make']ReflectionClass::newInstanceWithoutConstructor()__init@Value@Aspect@OnWorkerStartContainerresolve()MyClassFactory__invoke()make(string $mode)@Inject(MyClassFactory::class)$this->factory->make($mode)serialize/unserialize