@Inject(lazy: true) 未生效的根本原因是用在构造函数中触发了代理强制初始化，必须移至普通方法内调用；且需确保接口绑定、类型提示准确、Proxy缓存配置正确。
Hyperf 的 @Inject(lazy: true) 为什么没生效
根本不是注解写错了，而是你把它用在了错误的位置。只要还在构造函数里直接访问那个懒加载属性，@Inject(lazy: true) 就等于没加——因为此时代理对象会被强制初始化，容器还没完成依赖图构建，循环依赖照样抛 CircularDependencyException 或 TypeError: Call to a member function on null。
常见错误写法：
class UserService {
#[Inject(lazy: true)]
private HeavyServiceInterface $heavyService;
public function __construct() {
// ❌ 错误：这里一读 $this->heavyService 就触发代理实例化
$this->heavyService->warmUp();
}
}
- 必须把所有对懒加载属性的调用，全部移到普通方法体内（如
handle()、execute()） - 构造函数里只允许做类型检查类操作，比如
get_class($this->heavyService)是安全的 - 确保该属性有完整类型提示，且接口已在
config/autoload/dependencies.php中显式绑定
Lazy 注入必须配合接口绑定才能生效
Hyperf 的懒加载代理机制严重依赖类型一致性。如果你声明的是抽象类、未绑定的接口，或者用了 mixed、array 这类宽泛类型，代理会退化为普通注入，lazy: true 彻底失效。
- 绑定配置必须和属性类型提示完全一致：
App\Service\HeavyServiceInterface::class => App\Service\HeavyServiceImpl::class - 命名空间大小写敏感，
heavyServiceInterface和HeavyServiceInterface不等价 - 不要在属性上写
private $heavyService，必须带类型：private HeavyServiceInterface $heavyService - 若服务本身还依赖其他懒加载对象，整条链上每个环节都得满足上述条件，否则代理在某一层就断了
Proxy 类缓存不生效的三个硬性前提
启动慢八成是因为 Proxy 缓存压根没跑起来。它不是开关，而是一套权限 + 配置 + 命令的组合动作，缺一不可。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
runtime/目录必须可写，尤其runtime/container/proxy/要存在且能生成文件 -
config/autoload/scanner.php必须明确定义扫描路径，例如'paths' => ['app']；空配置或路径错会导致扫描跳过 - 必须用
php bin/hyperf.php start启动，watch模式默认禁用所有缓存，每次重启都是冷启动 - 验证是否生效：启动后检查
runtime/container/proxy/下是否有大量*Proxy.php和annotations.php文件
延迟注入不是绕过循环依赖，而是转移死锁点
很多人误以为加了 lazy: true 就万事大吉。其实它只是把死锁从容器初始化阶段，推迟到了第一次业务调用时。如果两个服务在各自 __construct 里都尝试触发对方的懒加载代理，问题照旧。
真正的解法永远是：让至少一方彻底不参与构造期依赖图。这通常意味着要重构依赖关系，比如把强依赖改成事件驱动、回调传参，或使用 Container::get() 在运行时按需获取——而不是靠懒加载“撑住”设计缺陷。
最容易被忽略的一点：懒加载不能掩盖接口职责不清、边界模糊的问题。一旦开始频繁靠 lazy 救火，就该回头重审模块划分了。
