Hyperf 3.0 默认启用 LazyLoader 实现按需实例化，解决 2.2 中启动慢、内存高、循环依赖报错不明确等问题；其通过首次 get() 或注入时才执行构造函数，但要求类具备可推导类型提示等“可懒加载”条件，否则退回到同步构造。
Hyperf 3.0 的依赖注入（DI）不再默认预加载所有服务，而是通过 LazyLoader 实现按需实例化——这直接解决了 2.2 中常见的启动慢、内存占用高、循环依赖报错不明确等问题。但前提是你的类必须满足“可懒加载”条件，否则会退回到同步构造，甚至触发警告。
LazyLoader 是什么，为什么 2.2 没有它
LazyLoader 不是新类，而是 Hyperf 3.0 DI 容器在解析依赖时的默认策略：当某个服务被首次 get() 或注入到目标方法参数时，才真正执行其构造函数和初始化逻辑。2.2 的容器在启动阶段就尝试实例化所有已注册服务（尤其在启用注解扫描后），导致：
- 哪怕只用一个
RedisPool，也会把全部DatabaseConnection、Logger、EventDispatcher全部 new 出来 - 含复杂初始化逻辑的类（如连接外部 API、读大配置文件）拖慢启动 5～10 秒
- 构造函数中调用
$this->get(XXX::class)极易触发隐式循环依赖，报错堆栈指向容器内部而非你自己的代码
哪些类会被 LazyLoader 跳过，导致立即实例化
不是所有类都能被懒加载。以下情况会强制提前构造，失去延迟优势：
- 类的构造函数参数含
mixed、array、callable等无法类型推导的类型提示（PHP 8.0+ 仍不支持array类型反射） - 构造函数有必填参数但未标注类型（如
public function __construct($config)），容器无法判断该注入什么 - 类被标记为
#[Singleton]且已在dependencies.php中显式绑定到具体类（如FooInterface::class => Foo::class），此时绑定优先级高于懒加载策略 - 使用了
@Inject注解但目标属性是private且父类也定义了同名private属性（2.2 同样失效，3.0 不再尝试修复）
如何确认某个服务是否真被懒加载了
不能只看启动日志有没有报错，得验证运行时行为：
- 在目标类构造函数第一行加
var_dump('init!');，然后只调用一个完全不涉及它的接口（如GET /health），若没输出，说明懒加载生效 - 检查
runtime/container/proxy/下是否生成了对应代理类文件（如FooProxy.php），这是LazyLoader工作的证据 - 启动后执行
php bin/hyperf.php di:info Foo，输出中若含lazy: true且instantiated: false，即为待加载状态 - 注意：若你在
config/autoload/dependencies.php中用了make匿名函数绑定，该函数会在启动时执行——这不是懒加载失效，是你主动放弃了延迟
手动控制懒加载开关的两个关键点
绝大多数场景应让容器自动决策，但遇到特殊需求时可干预：
- 想强制某接口立即初始化（比如要确保 Redis 连接池在启动时就建好），在
dependencies.php中绑定时加'shared' => true并确保构造函数无副作用 - 想禁用某类的懒加载（例如它内部有全局状态或静态初始化），在类上加
#[NoLazy]（Hyperf 3.0.27+ 支持），否则容器仍会尝试代理 - 别在
__construct里写业务逻辑，尤其是调用$this->get()或访问$container——这会让懒加载失去意义，还可能引发死锁
最常被忽略的是：LazyLoader 依赖 PHP 8 的完整类型反射能力，如果某个服务用了 #[\Attribute] 自定义注解并在构造函数里解析它，而该注解类本身没加 #[\Attribute] (flags: \Attribute::IS_REPEATABLE)，会导致反射失败，容器直接 fallback 到同步构造——这种问题不会报错，只会让你误以为“懒加载没起作用”。
