composer why-not 对虚拟包(如 psr/log)无效,因其无真实版本;应先用 composer show --tree 查提供者,再对提供包执行 why-not,并检查 require-dev 和根约束。

composer why-not 无法输出时,先确认是否涉及虚拟包
虚拟包(如 psr/http-message、psr/log、symfony/polyfill-php81)本身不发布代码,只靠 provide 字段被其他包“声明提供”。当 composer why-not vendor/package:version 输出为空,大概率不是命令写错,而是你在查一个虚拟包——它没有真实版本号,不能直接 why-not psr/log:^3.0。
这类冲突的真实表现是:报错里出现 don't install psr/log ^3.0,但 composer show psr/log 提示 “Package not found”。这时得换思路:
- 用
composer show --tree | grep "psr/log"查谁在provide它,重点关注带(provided)标记的行 - 对提供方运行
composer why-not,比如看到monolog/monolog (provided psr/log),就查composer why-not monolog/monolog:^3.0 - 检查
composer.json中是否显式写了"psr/log": "^2.0"—— 虚拟包不允许直接 require,这种写法会强制 Composer 尝试安装一个不存在的包,直接触发无解
报错提示 “don’t install virtual-package” 说明约束链里有硬性封杀
Composer 报出 don't install psr/http-message ^2.0,意味着某个已安装包通过 conflict 或过于狭窄的 require 主动拒绝该虚拟包的版本。这不是兼容性问题,是明确阻断。
常见来源:
-
guzzlehttp/guzzle:^7.0的conflict列表里锁死了psr/http-message ^2.0(它只认 ^1.0) - 你项目里某个老包(如
zendframework/zend-diactoros)已废弃,但它的composer.json仍写着"psr/http-message": "^1.0",且没声明provide,导致 Composer 认为它“独占”了 v1.x -
platform配置错误,比如设了"php": "7.4",而新虚拟包要求 PHP 8.0+,Composer 会把整个提供链判为不可用
用 composer show --tree 看清虚拟包的实际提供者
composer show --tree 是唯一能暴露虚拟包落地路径的命令。它不会显示 psr/log 自己,但会列出所有声明 provide 它的包,并标注锁定版本。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
例如执行 composer show --tree | grep -A3 -B3 "psr/log",可能看到:
monolog/monolog 3.0.0 └── psr/log (provided) 3.0.0 symfony/console 6.4.0 └── psr/log (provided) 2.0.0
这说明冲突根源不在 psr/log 本身,而在 monolog/monolog 和 symfony/console 提供的版本不一致。此时应查哪个包在阻塞对方升级,而不是试图“装” psr/log。
require-dev 是最常被忽略的虚拟包冲突源
很多虚拟包冲突实际来自 require-dev,比如 phpunit/phpunit 依赖旧版 sebastian/exporter,后者又要求 php >=7.3 且不提供 symfony/polyfill-php81;而你主应用用了 PHP 8.2 和新版 Laravel,后者需要该 polyfill 提供的函数。
排查方式:
- 临时注释掉
require-dev块,再跑composer update --dry-run -v,看冲突是否消失 - 单独查 dev 包:
composer why-not phpunit/phpunit:^10.0,输出里若出现sebastian/exporter,基本就是它卡住了整个 polyfill 链 - 别信
composer depends psr/log—— 它只列“谁 require”,不体现provide或conflict,对虚拟包完全无效
why-not,结果空输出还反复重试。真正该盯住的,是 show --tree 里那个带 (provided) 的包,以及 why-not 输出链末尾那行 Root package requires —— 那才是你亲手写的、正在拖后腿的约束。

















