Composer锁定共享依赖必须同时满足:composer.json中写死三位版本号(如"monolog/monolog": "2.11.0")、提交composer.lock至Git、部署时仅运行composer install;缺一不可。

不能靠 composer.lock 单独锁定共享依赖,必须在 composer.json 中显式写死三位版本号,并确保 lock 文件提交、部署时用 install —— 缺一不可。
composer.json 里怎么写才算真正锁住共享依赖
共享依赖(比如 monolog/monolog、symfony/polyfill-php81)和其他包一样,锁不住的根本原因常是写法松动:
- ❌
"monolog/monolog": "^2.11"→ 允许升到2.99.9,哪怕只改 patch 也失效 - ❌
"monolog/monolog": "2.11"→ Composer 2.0+ 解析为2.11.0,旧版可能当2.11.x,行为不一致 - ❌
"symfony/polyfill-php81": "dev-main"或@dev→ 每次 update 都拉最新提交,完全不固定 - ✅ 正确写法:
"monolog/monolog": "2.11.0"、"symfony/polyfill-php81": "1.32.1",不带任何符号
为什么改了 composer.json 还是装了新版本
常见断点不在“写没写”,而在“有没有同步进 lock”和“部署时有没有被绕过”:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 只改了
composer.json,但没运行composer update monolog/monolog→composer.lock仍是旧快照,install 时照装旧版,看似“没升”,实则根本没生效 - 运行了
composer update(无参数)→ 可能连带升级其他包,破坏原本稳定的间接依赖树 -
composer.lock被.gitignore忽略,或没提交 → CI 或新同事执行composer install时退化为按composer.json重解析,哪怕写了"2.11.0",也可能装上2.11.1(尤其国内镜像缓存了新 dist) - CI 脚本用了
composer install --no-lock→ 直接跳过 lock 校验,等同于强制 update
如何验证共享依赖是否真被锁住
别只看 composer show 输出,要交叉验证两步:
- 运行
composer show monolog/monolog,输出必须是精确的2.11.0(不是2.11.0.0或带-dev后缀) - 再跑一次
composer update monolog/monolog,如果提示Nothing to install or update,说明 lock 和 json 已对齐,且该包无升级空间 - 上线前加一道保险:
composer install --locked,它会校验 lock 里每个版本是否仍满足 json 约束;不满足直接报错退出,不让你糊里糊涂发版
最容易被忽略的是:共享依赖往往被多个包间接引入(比如 A → B → monolog),你只在 require 里锁了它,不代表它的子依赖路径不会被其他主依赖扰动。所以关键不是“锁没锁”,而是“锁之后有没有被别的地方悄悄覆盖”——最稳的方式,就是所有关键共享包都显式声明 + 三位号 + 提交 lock + 部署只走 install。

















