插件被 require-dev 精确版本锁死依赖树时,应先用 composer why-not 定位阻断包,核查其是否已支持新版依赖(如 phpstan 1.12+ 支持 nette/utils 5.x),若已支持则执行 composer require phpstan/phpstan:^1.12 --with-dependencies;未支持且需适配新 PHP 时可临时加 conflict 约束,但须慎用。

composer.json 里插件被 require 死锁,怎么破
插件(如 laravel/pint、phpstan/phpstan)一旦写进 require-dev 并带精确版本(比如 "phpstan/phpstan": "1.10.5"),它就可能反向锁死整个依赖树——尤其当它自身又强依赖某个旧版组件(如 nette/utils 4.x)时,会阻止其他包升级到兼容新 PHP 的版本。
常见错误现象:composer update 卡住不动,或报 Conclusion: don't install nette/utils v4.0.0,但你根本没直接 require 它。
- 先运行
composer why-not nette/utils:^5.0,看哪个插件在阻断升级 - 检查该插件的
composer.json(可查 packagist.org 页面),确认它是否已发布支持新版依赖的版本(比如phpstan/phpstan1.12+ 已切到nette/utils5.x) - 若插件官方已支持,直接
composer require phpstan/phpstan:^1.12 --with-dependencies;别只升主包,否则子依赖仍卡在旧版 - 若插件尚未更新,且你又必须用新 PHP(如 8.3),临时方案是加
"conflict": {"nette/utils": ">=5.0"}到项目根composer.json,强制 Composer 排除冲突路径(慎用,仅限短期)
插件通过 replace 字段“冒充”扩展,结果 autoload 失败
有些插件(如 symfony/polyfill-mbstring)靠 replace 声明自己能替代 ext-mbstring,但如果你项目里真装了 mbstring 扩展,而插件又没正确触发替换逻辑,composer dump-autoload -o 就可能漏掉关键类映射,导致运行时报 Class not found。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 执行
composer show symfony/polyfill-mbstring,确认输出里有replaces : ext-mbstring - 检查
vendor/composer/autoload_psr4.php是否包含该 polyfill 的命名空间映射;没有?说明replace没生效 - 删掉
vendor/和composer.lock,再跑composer install --no-cache,避免旧 lock 文件缓存了错误的替换状态 - 确保
platform配置没干扰:如果composer.json里写了"platform": {"ext-mbstring": "true"},Composer 会跳过 polyfill 的 autoload 注册
CI 环境里插件版本不一致,导致本地能跑线上挂
本地开发用 phpstan/phpstan 1.10,CI 流水线却因缓存或全局安装用了 1.9,结果类型检查规则不一致,phpstan analyse 在 CI 报错而本地不报——这不是代码问题,是插件版本漂移。
- 所有插件必须显式声明在
composer.json的require-dev里,禁用全局安装(如composer global require) - CI 脚本开头加
php -v和composer --version日志,确认环境一致性 - CI 中执行插件命令前,统一用
vendor/bin/phpstan而非全局phpstan,避免路径污染 - 若插件提供二进制文件(如
pint),检查vendor/bin/下对应软链接是否指向正确版本(ls -l vendor/bin/pint)
插件锁在 dev-main 分支,lock 文件反复变
某些插件(如内部工具包)用 "dev-main as 1.2.0" 锁定,但 dev-main 本身持续提交,composer.lock 里的 dist.sha256 就会每次都不一样,Git 提交后别人 composer install 会失败,报 “Your lock file does not contain a compatible set of packages”。
- 永远不要对
dev-分支做composer require vendor/package:dev-main,它本质是浮动引用 - 改用
composer require vendor/package:dev-main#commit-hash(如#a1b2c3d),把 commit ID 写死在composer.json中 - 或者,在
composer.json里加"minimum-stability": "stable"并设"prefer-stable": true,压制 dev 分支自动匹配 - CI 构建时加
--no-cache --no-plugins --no-scripts,防止插件自身脚本干扰 lock 文件生成
真正麻烦的不是插件版本本身,而是它通过 replace、conflict 或 platform 配置间接改变了整个依赖图的求解路径——这些字段不报错,但会让 composer show --tree 输出和你预期完全不同。










