Hyperf 架构演进围绕“高性能协程服务”持续重构：v3.x 以原生 Attributes 替代 Doctrine、强化类型契约、集成 Swow 引擎、升级可观测性。
Hyperf 的架构演进不是简单功能堆砌，而是围绕“高性能协程服务”这一核心目标持续重构的过程。从 v2.x 到 v3.1 LTS，每一次大版本升级都对应着底层理念、开发范式和工程能力的实质性跃迁。
PHP 注解体系：从 Doctrine 到原生 Attributes
v2.x 依赖 Doctrine Annotations 实现路由、中间件、注入等声明，存在解析开销大、IDE 支持弱、与 PHP 类型系统脱节等问题。v3.0 彻底弃用，全面转向 PHP 8.1+ 原生 Attributes：
- 语法更简洁，如
#[Controller(prefix: '/api')]替代冗长的 PHPDoc 注释 - 编译期校验增强，类型错误可在 IDE 中实时提示
- 注解处理零反射开销，启动速度提升约 15%～20%
- 官方提供
code:generate工具批量迁移旧注解，降低升级门槛
类型系统与契约强化：从松散到严格
v2.x 中大量方法缺少返回类型声明，参数类型模糊，导致运行时异常多、测试覆盖难。v3.x 系统性补全核心组件的完整类型契约：
- 监听器
process()方法强制返回void - AMQP 消费者统一使用
Result::ACK/REJECT/REQUEUE枚举作为返回值，杜绝字符串魔法值 - Context、Config、Event 等关键类全面标注泛型与不可变语义
- 配合 PHPStan 级别 7 检查，可提前捕获 60% 以上潜在类型错误
引擎与运行模型：Swow 集成与协程治理升级
v2.x 主要绑定 Swoole，而 v3.1 开始深度支持 Swow 引擎，并重构协程生命周期管理：
- Swow 协程栈更轻量，上下文切换开销降低约 35%，高并发下内存碎片显著减少
- 新增
Coroutine::defer()和结构化取消（Structured Concurrency）支持，避免协程泄漏 - HTTP Server 默认启用协程池隔离，防止慢日志、DB 查询阻塞整个 Worker
- 中间件执行模型明确分层：外层拦截 → 内层业务 → 响应反向传递，调试路径清晰可控
可观测性与运维能力：从基础监控到智能诊断
v2.x 提供 Prometheus 指标采集和简易日志，但缺乏深度洞察。v3.1 将可观测性作为一等公民设计：
- 默认集成 OpenTelemetry，支持自动链路追踪（Span）、指标（Metrics）、日志（Logs）三合一
- 错误页面携带完整协程 ID、父协程栈、上下文变量快照，定位异步问题效率提升 2 倍以上
- 资源监控面板支持实时查看协程数、内存占用、TCP 连接状态、慢请求 TopN
- 新增内存泄漏检测工具，可标记长期存活对象并关联创建位置
