应先运行composer diagnose定位不兼容插件,查其composer.json是否声明"composer-plugin-api": "^2.0",尝试更新或移除归档插件,切勿回退至已停止维护的Composer 1.x版本。

Composer 报 “Plugin X is not compatible” 怎么办
这是 Composer 升级后最典型的插件报错,本质是某个插件的 composer.json 里没声明支持 "composer-plugin-api": "^2.0"。它不拦你装包,但会在 composer install 或 composer update 启动阶段直接中断。
- 先跑
composer diagnose,它会明确指出哪个插件不兼容(比如输出The plugin hirak/prestissimo is not compatible with Composer 2) - 查该插件在 Packagist 页面的
composer.json,重点看require段有没有"composer-plugin-api": "^2.0";没有就说明作者还没适配 - 别急着删——试试
composer update vendor/plugin-name,有些作者悄悄发布了兼容版但没更新 README - 若插件已归档(如
hirak/prestissimo),且报错是Class Prestissimo\Plugin not found,用composer remove hirak/prestissimo临时移除 - 切勿回退 Composer 到 1.x:v1 已停止维护,存在已知安全漏洞,且与 PHP 8.2+ 的某些 autoloading 行为不兼容
想回退某个依赖包(比如 monolog/monolog)到 v1.x
手动改 composer.json 版本号再 composer update 是高危操作——它会触发全新依赖解析,可能把 psr/log 从 1.x 推到 3.x,引发运行时类找不到。
- 先确认目标版本可用:
composer show -a monolog/monolog,找带stable标签且未被abandoned的 v1.x 版本(如v1.27.1) - 执行
composer require monolog/monolog:^1.27 --with-all-dependencies,它会重写composer.lock中该包及其所有子依赖的版本和 hash - 如果报
Your requirements could not be resolved,立刻跑composer why-not monolog/monolog:1.27.1查谁在拦路 - 注意
--with-all-dependencies的副作用:它可能连带升级其他间接依赖,执行前建议git diff composer.lock预览改动范围
composer.lock 被新版 Composer 污染后怎么干净回滚
常见于 CI 用了 Composer 2.5+ 生成 lock,而本地开发机是 2.1.x ——结果 composer install 直接报错 Your lock file does not contain a compatible set of packages,不是网络问题,是 lock 文件里写了旧版不识别的字段(如 content-hash 格式变更或平台扩展字段)。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 必须同时删掉
vendor/和composer.lock,只删 vendor 无效 - 用项目文档指定的 Composer 版本重建依赖:比如文档写明“需 Composer 2.1.x”,就用
docker run --rm -v $(pwd):/app -w /app composer:2.1 install - 若只有
composer.json没有 lock,别直接install——先用目标版本的 Composer 执行composer update --lock生成兼容 lock,再交给 CI - 别信
composer config -g repo.packagist输出值,它只反映配置是否写入,不保证实际生效;验证镜像是否真起作用,得看composer update -vvv日志里请求的 URL 域名
老项目里已装了高版本包,但代码只兼容旧版
Composer 不会在每次 require 时校验已安装包是否超出 composer.json 约束——也就是说,"monolog/monolog": "^1.23" 被人 update 过一次升到 2.x 后,install 仍会安静地复用那个不兼容的 2.x 版本,直到运行时报 Class 'Monolog\Logger' not found。
- 用
composer show monolog/monolog确认当前实际安装版本,别只信composer.json - 降级必须显式触发:
composer require monolog/monolog:^1.23 --no-update先改 JSON,再composer update monolog/monolog重装该包(不加--no-update会导致其他包也被拉新) - 长期防护靠组合约束:
"prefer-stable": true防 dev 分支、"conflict": {"monolog/monolog": ">=2.0.0"}硬封杀危险大版本 - 硬锁定(如
"==1.27.1")看似安全,但会跳过所有安全补丁更新,除非你每天手动 check CVE 并 patch
真正麻烦的从来不是“怎么回退”,而是回退后如何防止下次又被推上去——composer.lock 的哈希、CI 使用的 Composer 版本、团队成员本地的全局配置,三者稍有不一致,就会让 lock 文件在提交时悄悄变异。










