hyperf启动慢的核心原因是注解扫描范围过大和aop代理生成失控。应精准限定config/autoload/annotations.php中scan.paths为controller/service/model等必要目录，禁用auto_binding，关闭非必要aop切面，并避免trait上使用@aspect。
Hyperf 启动慢，核心原因不是代码写得差，而是注解扫描范围过大 + AOP 代理生成失控 —— 这两项在启动时集中爆发，直接拖垮 Bootstrapping 阶段。
如何限制 @Controller 和 @Service 的扫描路径
默认情况下，Hyperf 会递归扫描 app/ 下所有 PHP 文件，哪怕你把测试类、Migration、Command 都放进去，它也照扫不误。这不是“智能发现”，是“无差别轰炸”。
实操建议：
- 在
config/autoload/annotations.php中显式指定扫描目录，删掉模糊的app/，改用精确路径：'scan' => [ 'paths' => [ BASE_PATH . '/app/Controller', BASE_PATH . '/app/Service', BASE_PATH . '/app/Model', ], 'ignore_annotations' => ['mixin'], ],
- 确保
app/Command、app/Job、app/Exception等非注解驱动目录**不在扫描列表里**；它们靠 DI 容器自动加载即可，无需注解支持 - 如果用了
@Aspect，它的扫描是独立的，别把它和 Controller 扫描混在一起——Aspect 类建议单独放在app/Aspect，并在annotations.php中单独配'aspects'路径
为什么 @AutoWired 和 @Inject 会拖慢容器初始化
DI 容器不是“用到才解析”，而是在启动时就预构建整个依赖图。一旦某个 @Service 类的构造函数参数类型提示指向了未声明的接口，或引用了未注册的抽象类，容器就会尝试“猜”实现类，触发额外反射和查找逻辑，甚至引发无限递归扫描。
常见错误现象：
- 启动日志卡在
Initializing container...超过 5 秒 - 内存峰值突然冲高（>256MB），然后回落
-
php bin/hyperf.php start --debug报出ReflectionException: Class xxx does not exist，但实际类存在且命名正确（说明容器在错误路径下反复尝试加载）
解决方向：
- 所有
@Inject属性必须对应一个已注册的Bean或具体类（避免注入 interface 但没配@Bean实现） - 禁用“自动绑定”：在
config/autoload/container.php中设'enable_auto_binding' => false，强制显式声明依赖 - 对高频使用的 Service，加
@Singleton注解，避免每次请求都 new 实例（虽然不影响启动，但能降低后续内存抖动）
关闭不必要的 AOP 切面与代理生成
AOP 是 Hyperf “重”的主要推手之一。@Trace、@CircuitBreaker、@RateLimit 这些注解本身不耗时，但它们触发的代理类生成（Proxy Class）会在首次调用前完成，并写入 runtime/container/proxy。如果切面太多、目标方法太散，代理文件数量爆炸，IO + 写磁盘 + opcode 编译全被拉长。
关键判断点：
- 开发环境可直接关掉所有 AOP：在
config/autoload/aop.php中设'enable' => false，启动立刻快 3–5 秒 - 生产环境保留必要切面，但务必限制作用范围：
'App\Aspect\RateLimitAspect' => [ 'include' => ['App\Controller\Api\*'], 'exclude' => ['App\Controller\Api\TestController'], ],
- 避免在
trait上打@Aspect注解——Hyperf 会为每个 use 该 trait 的类都生成一份代理，极易重复
真正容易被忽略的是：runtime/ 目录权限和磁盘 IO 性能。Windows 下 WSL2 + ext4 分区比 Docker Desktop 共享卷快一个数量级；Mac 上用 APFS 加速 Spotlight 索引也会干扰扫描速度。启动慢从来不是单点问题，而是注解路径、容器配置、AOP 范围、文件系统四层叠加的结果。
