Composer卡在Resolving dependencies是SAT求解器暴力回溯版本冲突所致,非网络问题;应先用composer why-not定位阻断链,再清理缓存或调整约束。

composer update 为什么总卡在 Resolving dependencies?
不是网速慢,是 SAT 求解器在暴力回溯版本约束冲突。一旦 composer.json 中存在隐式矛盾(比如两个包 require 不兼容的 laravel/framework 版本),它就会无限尝试组合,直到超时或手动中断。
验证方式:加 -vvv --profile 运行,如果日志停在 Resolving dependencies through SAT,就确认是约束问题,不是缓存脏了。
- 别急着删缓存——先用
composer why-not vendor/package:version定位哪个包在阻断升级 - 若输出显示某扩展包被
conflict或其依赖链中某个require锁死了旧版框架,就得手动调整约束或临时移除该包 - 只有当
why-not报错或无输出、且日志卡在Reading packages.json from cache时,才进入缓存清理流程
清哪些缓存才真正有效?
composer clear-cache 只清 ~/.composer/cache/files/ 和 ~/.composer/cache/repo/ 下的压缩包和索引快照,但 vendor/composer/installed.json 和 composer.lock 是本地状态文件,不会被碰——而它们恰恰是 update 时决策的依据。
真正要动的三处是:
-
rm -rf ~/.composer/cache/repo/https---packagist.org/(强制重拉 metadata) -
rm -f vendor/composer/installed.json(避免composer show误报已安装版本) -
rm -f composer.lock(让 update 从头解析,而非基于旧 lock 做增量更新)
执行完再跑 composer update --dry-run -v,观察是否出现 Downloading https://repo.packagist.org/packages.json —— 出现了,说明 metadata 真清干净了。
如何让 update 后自动清 Laravel/Symfony 缓存?
Composer 不知道你的框架有 cache:clear,也不会主动调用。必须靠 post-update-cmd 钩子补上这一步。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
编辑 composer.json 的 scripts 段:
"scripts": {
"post-update-cmd": [
"@php artisan config:clear",
"@php artisan route:clear",
"@php artisan view:clear"
]
}
注意点:
- 用
@php而不是php,避免 Windows 下找不到 php 可执行文件路径 - 不要在钩子里加
php artisan optimize或config:cache,这些命令依赖当前缓存已清空,顺序错了会失败 - 如果项目含多个环境(dev/staging/prod),建议把清理逻辑抽成
bin/clear-app-cache.php,再在钩子里调用,便于条件判断
想只更新一个包,又怕牵连其他依赖?
直接运行 composer update vendor/package-name 即可,它只会升级指定包及其直系依赖(满足其 require 的最小集合),不会动其他无关包。
但要注意:
- 如果该包的
require和你根composer.json冲突(比如它 requirephp: ^8.2,而你锁了php: ^8.1),update 仍会失败 - 执行后
composer.lock会被重写,所有变更都会记录进去,所以仍需同步提交 lock 文件 - 不推荐在 CI/CD 流程中用这个命令——它破坏了依赖的确定性;生产部署应始终用
composer install+ lock 文件
最易被忽略的是:即使只更新单个包,Laravel 的 config:cache 或 Symfony 的容器缓存也必须手动清,因为框架缓存文件里固化的是类名和接口签名,和 vendor 代码强绑定,差一个 patch 版本都可能出 Class not found。

















