对千万级类文件项目，仅用composer dump-autoload -o会因反序列化8–12MB classmap拖慢启动；必须组合启用--classmap-authoritative、限定classmap范围、APCu缓存autoloader实例及OPcache预加载。
直接结论：对千万级类文件的项目，光靠 composer dump-autoload -o 不仅无效，反而拖慢启动——必须禁用 PSR-4 fallback、限定 classmap 范围、强制 APCu 缓存 autoloader 实例，并确保 OPcache 预加载生效。
为什么 dump-autoload -o 在超大项目里变慢
Composer 2.x 的 -o 会把所有 PSR-4 扫描结果写进 vendor/composer/autoload_classmap.php，类数超 50 万时该文件常达 8–12MB。每次 PHP 请求都要反序列化整个数组，但单次请求实际只用到其中不到 0.3% 的条目。
- 冷启动时
include这个大文件本身就要 30–60ms（PHP 8.2 + ext-opcache） - OPcache 虽缓存 opcode，但无法压缩反序列化开销；若
opcache.memory_consumption < 256M，还可能频繁踢出其他关键脚本 - APCu 默认不缓存这个数组——它只缓存用户变量和 opcode，而 autoloader 是运行时构造的对象
--classmap-authoritative 必须配 --optimize，且不能漏掉路径
加了 --classmap-authoritative 后，Composer 会跳过所有未命中 classmap 的 PSR-4 文件系统查找。但前提是 classmap 必须覆盖全部生产代码——它不会自动扫描你没声明的目录。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 在
composer.json中显式列出关键路径："classmap": ["src/", "app/", "lib/"]，别写"."或宽泛的"packages/" - 删掉测试目录、文档、示例代码的 autoload 配置，它们只会增大 classmap 体积
- 执行命令必须是
composer dump-autoload --optimize --classmap-authoritative --no-dev，三者缺一不可 - 验证是否生效：检查
vendor/composer/autoload_static.php中是否存在'classMapAuthoritative' => true
APCu 缓存的是 autoloader，不是 classmap 数组
很多人误以为 --apcu 会缓存 autoload_classmap.php 内容，其实它缓存的是 Composer 加载器内部的类名→路径映射哈希表（key 形如 composer-apcu-autoloader-xxx），用于跳过 ClassLoader::findFile() 中的循环匹配逻辑。
- 必须开启
apc.enable_cli=1，否则 CLI 下生成的缓存对 Web 进程不可见 -
apc.shm_size至少设为128M（classmap 条目超 100 万时建议256M） - 缓存 key 命中率低？用
apcu_cache_info('user')查看num_hits / (num_hits + num_misses)，低于 95% 就说明有路径没扫全或命名空间冲突 - 更新代码后需手动清空：
apcu_clear_cache('user')，否则旧映射仍生效
OPcache 预加载才是终极加速点
即使 classmap 和 APCu 都到位，每次请求仍要执行 require vendor/autoload.php 并初始化加载器对象。PHP 7.4+ 的预加载可把核心 autoload 文件在 FPM 启动时就编译并驻留内存，彻底消除运行时加载开销。
- 生成预加载文件：
composer dump-autoload --optimize --classmap-authoritative --no-dev && php -d opcache.preload=/dev/null -r "echo 'vendor/composer/autoload_static.php';" - 在
php.ini中配置：opcache.preload=/path/to/project/vendor/composer/preload.php（需自行编写或用工具生成） - 必须关闭
opcache.revalidate_freq=0，否则预加载失效 - 注意：预加载文件不能包含动态逻辑（如
__DIR__、getcwd()），否则 FPM 启动失败
真正卡住性能的从来不是磁盘 I/O，而是 PHP 进程反复构建 autoloader 实例、重复反序列化百万级数组、以及每次请求都重新解析同一段静态映射逻辑。这些环节一旦固化进预加载+APCu+权威 classmap 的组合，类加载才能从毫秒级压进微秒级——但前提是你得亲手把每层缓存的边界划清楚，而不是指望一个 -o 参数自动搞定一切。
