全量缓存预热需同步完成三块：依赖包下载缓存、自动加载映射固化、框架级运行时缓存生成；缺一导致首请求卡顿，核心是构建阶段未将vendor、autoload_classmap.php、bootstrap/cache及preload.php等确定性产物打入镜像。
全量缓存预热不是“多跑几遍 composer install”就能解决的，它必须拆成三块独立但强耦合的动作：依赖包下载缓存、自动加载映射固化、框架级运行时缓存生成。漏掉任意一块，上线后首请求仍会卡顿。
为什么 composer install 在集群里总要重下包？
根本原因不是网络慢，而是每个节点启动时都从空 ~/.composer/cache/ 开始——哪怕你配了阿里云镜像，Composer 仍得重新下载 ZIP、校验哈希、解压、写缓存。更糟的是，如果 CI 构建阶段用了 --no-scripts 或 --no-autoloader，vendor 目录虽存在，但 autoload_classmap.php 和 bootstrap/cache/ 下的编译文件全是空的。
- 确认缓存路径是否真生效：
composer config --global --list | grep cache-dir，别只设COMPOSER_CACHE_DIR环境变量，全局 config 里有冲突配置会覆盖它 - CI 构建镜像时，必须把整个
~/.composer/cache/打进镜像（或挂载为 volume），不能只拷vendor/ - 用
composer clear-cache清旧缓存再测，否则可能复用失效的哈希记录
如何让 autoload_classmap.php 真正起效？
加了 --optimize --classmap-authoritative 不代表就提速了。这个 classmap 必须被 autoload 加载器读取，且 opcache 要能稳定缓存它。否则每次请求还是走 PSR-4 的 file_exists() 判断。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 生成后检查
vendor/composer/autoload_classmap.php文件大小——几百行说明没扫到类；几千行才正常 - 打开
vendor/composer/autoload_real.php，搜索addClassMap：没这行调用，说明 classmap 根本没注册进去 - 线上验证：
php -d opcache.enable=1 -r "require 'vendor/autoload.php';"，再查opcache_get_status()['scripts']里有没有该文件路径 -
classmap字段只写结构稳定的目录，比如["app/Exceptions/", "app/Contracts/"]，别塞app/Http/Controllers/这种高频增删的目录
框架缓存（config/route/view）为什么总在首次访问才生成？
因为 post-install-cmd 脚本默认在 CI 构建时就被跳过了，或者执行时环境变量缺失、数据库连不上，导致 php artisan config:cache 静默失败，日志里只显示 “install completed”。
- 别直接在
composer.json里写命令列表，改用封装脚本："post-install-cmd": ["php scripts/WarmUp.php"] -
scripts/WarmUp.php开头必须加守卫：if (getenv('APP_ENV') !== 'production') { exit(0); }，否则开发机装依赖也会触发 - 脚本内用
set_time_limit(120)防卡死，每条artisan命令后检查proc_open返回值，失败立刻exit(1) - 确保构建镜像时
APP_ENV=production已注入，且.env不随代码提交（用 k8s configmap 或 secrets 注入）
opcache preload 能不能一键搞定所有类预加载？
不能。Composer 本身不参与 preload，composer dump-autoload 也不支持 --preload 参数。所谓“全量预加载”，其实是两步：先用 composer dump-autoload -o -a 生成权威 classmap，再由你自己写的 preload.php 按顺序 require_once 每个类文件——而且必须是绝对路径，不能含任何动态逻辑。
- 别 require
vendor/autoload.php：它含闭包和条件判断，PHP 启动时会报Cannot preload class … because it was already defined - 用
vendor/composer/autoload_classmap.php里的路径拼接：require_once __DIR__ . '/../' . $path; - preload 脚本里禁止调用未定义函数、禁止
define()、禁止访问$_ENV——它在 PHP 主进程启动时执行，什么都没初始化 - PHP 版本必须 ≥ 8.0，且
opcache.preload配置项指向该脚本，opcache.enable=1必须开启
最常被忽略的点是：缓存预热不是部署时“顺手做的事”，而是构建阶段就必须 baked in 镜像的确定性产物。vendor、classmap、bootstrap/cache、甚至 preload.php，全部要在 CI 流水线结束前完成并验证，上线那一刻才真正“全量就绪”。
