“virtual package not found”并非真实包缺失,而是Composer在依赖解析时未能找到满足约束的提供者(如monolog/monolog提供psr/log-implementation),主因是PHP版本、扩展、稳定性或platform配置导致提供者被排除。

composer install 报 “virtual package not found” 是什么情况
这不是真实包缺失,而是 Composer 在解析依赖时,把某个 provide 声明的虚拟包(比如 psr/log-implementation、laravel/framework 的替代实现)当成了必须安装的实体包。常见于手动删了 vendor 但没清锁文件、或用了 --ignore-platform-reqs 后又切回正常环境。
为什么 composer show psr/log-implementation 找不到任何结果
因为虚拟包本身不发布代码,只靠其他包在 composer.json 的 "provide" 字段声明自己“提供”它。Composer 只在依赖解析阶段用它做版本匹配,不把它列在可安装包列表里。
- 运行
composer depends psr/log-implementation会报错 —— 它不是被依赖,而是被“提供” - 真正该查的是谁提供了它:
composer show monolog/monolog | grep -A2 provide(输出类似"psr/log-implementation": "^1.0") - 如果所有候选包都因 PHP 版本/扩展/稳定性设置被排除,Composer 就会卡在“找不到实现”,报错却指向虚拟包名
修复步骤:先确认提供者是否真被允许安装
重点不是找“虚拟包”,而是看哪个实际包该提供它、又为什么没被选中:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 执行
composer why-not psr/log-implementation—— 大概率返回空或“no matching packages”,说明没有包满足当前约束 - 改查具体提供者:
composer why-not monolog/monolog,看是 PHP 版本不匹配、还是ext-mbstring缺失、或是"minimum-stability": "stable"拦住了 dev 分支 - 检查
composer.json是否写了"conflict": {"psr/log-implementation": "*"}这类反向声明(极少见但存在) - 删掉
"config": {"platform": {"php": "8.1.0"}}再试 —— 硬编码 platform 会让 Composer 忽略本地真实 PHP 版本,导致提供者被错误排除
别碰 composer require psr/log-implementation
这条命令永远失败,因为虚拟包不能直接 require。你真正要做的只有三件事:
- 确保至少一个提供者(如
monolog/monolog、symfony/debug-bundle)在require或间接依赖树里 - 确认它的版本约束和你的 PHP/扩展/稳定性设置兼容(用
composer check-platform-reqs验证) - 删掉
vendor/和composer.lock后重跑composer install—— 不是为了清缓存,而是强制重新走一遍解析逻辑,让虚拟包绑定关系重建
最常被忽略的点:虚拟包报错从来不是网络或镜像问题,它只暴露你本地环境或配置中某个提供者被静默过滤掉了。盯着 why-not 输出里的第一个“excluded by”提示,比翻文档快十倍。










