Hyperf 中 LazyProxy 不能直接用于属性注入，因为属性注入在构造后立即赋值，无法触发代理的 __get 拦截；PHP 不支持对 public 属性拦截，且容器不为属性自动生成代理逻辑。
Hyperf 中 LazyProxy 为什么不能直接用于属性注入？
Hyperf 的容器默认不支持对类属性（property）做懒加载代理注入——哪怕你写了 #[Inject] + LazyProxy，运行时仍会立即实例化依赖。这是因为属性注入发生在对象构造完成后的赋值阶段，此时代理尚未“接管”访问逻辑，__get 或拦截机制根本不会触发。
常见错误现象是：服务启动时报 Class not found 或提前抛出初始化异常，明明该依赖本该延迟到第一次调用才创建。
- Hyperf 的
LazyProxy设计目标是代理「方法调用」，不是「属性访问」 - PHP 不允许对 public 属性做魔术方法拦截（
__get/__set对 public 属性无效） - 即使把属性设为
protected并配合__get，Hyperf 容器也不会自动为你生成代理逻辑
正确姿势：用 LazyProxy 代理一个「可调用对象」而非属性
真正可行的懒加载路径是：把依赖声明为一个闭包或工厂函数，再用 LazyProxy 包裹它；实际使用时通过调用（()）触发代理逻辑，从而延迟实例化。
示例场景：某 Controller 需要一个开销大的 ReportGenerator，但仅在 exportAction 中用到：
// 在 __construct 或 @Inject 方法中
$this->reportGeneratorFactory = new LazyProxy(function () {
return make(ReportGenerator::class);
});
使用时写成：
public function exportAction()
{
$generator = ($this->reportGeneratorFactory)(); // ← 注意括号调用
return $generator->generate();
}
- 必须显式调用
$proxy()，不能写成$proxy->method()（那会尝试调用LazyProxy自身的方法） - 工厂函数里推荐用
make()而非ApplicationContext::get()，避免在非协程上下文出错 - 如果工厂函数需访问当前容器作用域（如请求级实例），记得用
app()或Container::get()获取最新实例
替代方案：用 getter 方法 + LazyProxy 更安全
比起暴露工厂变量，封装成私有 getter 是更清晰、不易误用的方式。Hyperf 容器能正常注入依赖，而懒加载逻辑藏在方法里。
private ?LazyProxy $reportGeneratorProxy = null;
public function getReportGenerator(): ReportGenerator
{
if ($this->reportGeneratorProxy === null) {
$this->reportGeneratorProxy = new LazyProxy(function () {
return make(ReportGenerator::class);
});
}
return ($this->reportGeneratorProxy)();
}
这样调用就自然多了：
public function exportAction()
{
$this->getReportGenerator()->generate(); // 语义明确，无括号混淆风险
}
- 避免了在构造函数里过早触发
make()，也规避了属性注入时机问题 - getter 可加类型提示、PHPDoc，IDE 支持更好
- 若后续想改造成单例缓存，只需在 getter 内加个静态变量或属性缓存即可
别踩坑：协程安全与生命周期陷阱
LazyProxy 本身不感知协程，但它包裹的工厂函数如果依赖请求上下文（如 RequestInterface），就必须确保调用发生在协程内，且容器已绑定当前协程作用域。
- 在
onWorkerStart或命令行任务中直接调用懒加载代理，可能因ApplicationContext未初始化而报Container is not initialized - 不要在
__construct中预调用($proxy)()，否则等于取消懒加载 - 若被代理类含
__destruct或资源释放逻辑，注意：代理对象销毁 ≠ 原始对象销毁，延迟创建的对象生命周期由你控制
最易被忽略的是：LazyProxy 创建后，工厂函数里的依赖解析是「每次调用都执行一次」，不是单例——除非你在工厂函数里自己做缓存或用 make() 的单例行为（取决于该类是否注册为 singleton）。
