Composer update异常时盲目clear-cache无效，真正问题常是损坏ZIP、过期metadata或锁死composer.lock；应定位失败点后精准清理三处缓存并配合--no-cache与--force-checksums重装。
Composer update 执行异常（卡住、报错、拉不到新版）时，盲目运行 composer clear-cache 往往无效——它只清了缓存目录，但真正阻断更新的，常是损坏的 ZIP、过期的 metadata 或锁死的 composer.lock。
定位具体失败点：看 composer update -vvv 最后一行
别猜，直接加详细日志：
- 如果停在
Downloading https://mirrors.aliyun.com/composer/.../packages.json→ 是元数据拉取失败，重点清repo/ - 如果报
Failed to extract vendor/symfony/console或Corrupted zip file→ 是files/下某个 ZIP 损坏，不能全删缓存 - 如果反复出现
Resolving dependencies through SAT超 3 分钟 → 不是缓存问题，是依赖冲突，该用composer why-not查链路 - 如果输出里有
Using version ^2.1.0 for monolog/monolog但你明明知道 v3 已发布 → metadata 缓存没刷新，clear-cache不够，得手动清repo/https---packagist.org/
精准清理三处关键位置，而非一键清空
composer clear-cache 只删 ~/.composer/cache/files/、repo/、vcs/，但实际生效需配合项目层清理：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 删损坏 ZIP：
ls -l ~/.composer/cache/files/*symfony*console*.zip（Linux/macOS）或 PowerShell 中Get-ChildItem "$env:APPDATA\Composer\Cache\Files" -Filter "*console*.zip"，只删匹配项 - 清 metadata 缓存：
rm -rf ~/.composer/cache/repo/https---packagist.org/（Windows 对应路径同理），这个目录存的是包索引快照，不清它，update就永远看不到新版本 - 同步清理项目文件：
rm -f composer.lock vendor/composer/installed.json；漏掉composer.lock，所有校验都绕不过它硬编码的dist.sha256
重装必须带两个强制参数：--no-cache 和 --force-checksums
只删缓存不等于重装干净。Composer 默认仍会尝试复用本地 ZIP 并校验哈希，坏文件还在就继续失败：
-
--no-cache：跳过~/.composer/cache/files/，强制重新下载 dist 包 -
--force-checksums：让校验失败立刻报错退出，而不是静默跳过或写入损坏内容到vendor/ - 完整命令：
composer install --no-cache --force-checksums（不是update） - CI 环境中务必加
--no-interaction，否则clear-cache会卡在确认提示
最容易被忽略的是：缓存路径可能被 COMPOSER_CACHE_DIR 环境变量或公司镜像覆盖，composer config --global cache-dir 才是唯一可信路径；手删前务必确认 Composer 进程已退出，否则删到一半被写入，后续报 Corrupted cache file 就得重来。
