hyperf 生产启动慢主因是 autoload 未优化：需用 composer install --no-dev --optimize-autoloader --classmap-authoritative，并手动配置 autoload.classmap 包含 app/ 等目录，同时强制启用 opcache（含 cli）与 apcu。
Hyperf 生产环境启动慢，90% 不是框架本身的问题，而是 vendor/autoload.php 加载时反复扫描目录、构建 PSR-4 映射、触发大量 stat() 和 file_exists() 系统调用 —— 尤其当 OPcache 未启用或未命中时，这个过程每次请求都重来。
为什么 composer dump-autoload -o 在 Hyperf 里基本没用
这个命令在 Composer 2.x 中只是 --classmap-authoritative 的别名，它不重建 vendor/composer/autoload_classmap.php，只刷新轻量级的 autoload_static.php。而 Hyperf 的核心类（如 AppControllerIndexController）默认走 PSR-4，-o 并不会把它们扫进 classmap，除非你显式配置了 "classmap" 字段。
- 执行后检查
vendor/composer/autoload_classmap.php：文件不存在或只有几十行 → 根本没生效 - Hyperf 的
app/目录默认不在 classmap 范围内，光跑dump-autoload -o不会自动包含它 - CI/CD 里用了这个命令，本地能跑、线上启动卡住或报
Class not found是常态
真正该跑的命令是 composer install --no-dev --optimize-autoloader --classmap-authoritative
这条命令强制 Composer 重新解析所有依赖（不含 require-dev），并基于当前 composer.json 的 autoload 配置生成精简 classmap —— 这才是 Hyperf 生产部署唯一可信的构建动作。
-
--no-dev是硬性前提：否则phpunit、mockery等测试类会混入 classmap，体积暴涨至 3–5 MB，反序列化开销远超收益 -
--classmap-authoritative让 autoloader 完全信任 classmap，查不到就报错，跳过全部 PSR-4 fallback 路径，砍掉无效stat() - 必须确保
composer.json里有"optimize-autoloader": true和"classmap-authoritative": true，否则下次composer update会丢掉这些配置
Hyperf 项目必须手动加 "classmap" 才能覆盖核心代码
Hyperf 默认只靠 PSR-4 加载 app/ 下的类，但 dump-autoload -o 或 install -o 都不会自动把它加入 classmap —— 你得显式声明：
"autoload": {
"psr-4": {
"App\": "app/"
},
"classmap": ["app/", "config/", "runtime/container/"]
}
-
app/是必须项：否则控制器、服务、命令等都不会进 classmap -
config/和runtime/container/可选：如果项目用了配置预加载或容器预编译，加进去能进一步减少运行时查找 - 删掉
autoload-dev里的"Tests\": "tests/"，否则即使加了--no-dev，某些插件仍可能触发其解析
OPcache 和 APCu 不是可选项，是必配项
没有 OPcache，classmap 再大也白搭；没有 opcache.enable_cli=1，composer install 生成的文件连自己都缓存不了。
- PHP-FPM 配置中必须设：
opcache.enable=1、opcache.enable_cli=1、opcache.revalidate_freq=0 - 验证是否生效：
php -d opcache.enable=1 -r "require 'vendor/autoload.php';"，再查opcache_get_status()['scripts']里有没有vendor/autoload.php - Hyperf 支持
"apcu-autoloader": true（写在composer.json的config块），但前提是apc.enabled=1且apcu.enable_cli=1
最容易被忽略的是：classmap 不是“越全越好”。Hyperf 启动时要加载整个 autoload_classmap.php 数组，哪怕只用到其中 3% 的类。如果 app/ 下频繁增删控制器，又没同步更新 classmap，开了 --classmap-authoritative 就直接炸锅 —— 这不是优化失败，是边界没划清。
