Composer报“virtual package not found”是因误将provide声明的接口包(如psr/log)当作真实包require,导致解析器去仓库查找不存在的虚拟包;正确做法是删除显式require,由实现包(如monolog)通过provide自动满足。

“虚拟包”不是 Composer 的正式概念,报错里出现类似 virtual package、provides、replaces 或 “no matching package found” 但实际没写错包名,基本是 composer.json 中的 provide 字段配置出问题,或某依赖用 replaces 声明替代关系后导致解析器误判。
为什么 composer install 会说 “virtual package not found”?
这不是网络或镜像问题,而是 Composer 在解析依赖时,把某个 "provide" 条目当成了真实可安装包来查——但它根本不存在于任何仓库。常见诱因:
-
"provide": {"psr/log": "1.0.0"}写在了根项目composer.json里,但没配"type": "metapackage"或"type": "library",Composer 就会尝试去 Packagist 查这个“虚拟包” - 某依赖(比如
monolog/monolog)在自己的composer.json里写了"replace": {"psr/log": "*"},而你又在项目里显式 require 了psr/log,造成双向声明冲突 - 私有包用了
"type": "package"但漏写"dist"或"source"字段,Composer 把它识别为“仅提供能力、不可安装”的虚拟实体
日志里看到 “Could not find package xxx” 但 xxx 是个 interface 包怎么办?
像 psr/log、psr/container 这类规范包本身不带实现,只定义接口,它们的正确用法是被其他包通过 provide 满足,而不是直接 require。错误日志往往藏在 verbose 输出末尾:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
composer install -v | grep -A5 -B5 "psr/log"
关键看两行:
- 是否出现
Resolving dependencies through SAT后紧跟着Skipped virtual package psr/log——说明 Composer 已识别它是虚拟的,但你又在 require 它,就会报错 - 是否出现
Conclusion: don't install psr/log 2.0.0——说明某依赖(如symfony/console)明确conflict了该版本,得用composer prohibits psr/log:2.0.0查谁拦路
怎么验证某个包是不是被“provide”正确覆盖了?
别只信 composer show 列出来的包,要确认自动加载和运行时是否真可用:
- 执行
composer show psr/log:如果返回Package not found,但项目能正常跑日志代码,说明已被其他包(如monolog/monolog)通过provide覆盖 - 执行
composer depends psr/log:若无输出,说明没人 require 它;若有输出(如myproject requires psr/log ^2.0),就得删掉这行,改由实现包间接满足 - 检查
vendor/composer/autoload_psr4.php:搜索Psr\Log\,看是否有映射——没有就代表接口没被加载,即使装了也白搭
最易忽略的一点:很多团队在升级到 Symfony 6+ 或 Laravel 10+ 后,会手动加 "psr/log": "^3.0" 到 require,却忘了这些框架已自带 provide。结果就是 Composer 认为“你既要虚拟接口,又要真实包”,直接拒绝解析——删掉那行,让框架自己决定用哪个实现。

















