根本原因是Satis生成的packages.json缺失require等关键字段,导致Composer无法解析子依赖;需启用"providers": ["*"]、"require-dependencies": true并全量重建元数据。

本地 Composer 仓库元数据恢复后,composer install 仍装不出完整依赖树?问题不在 lock 文件,而在 packages.json 里 require 字段根本没被写进去。
为什么 restore 后 vendor 缺子依赖?元数据字段丢失是主因
备份恢复的不是 ZIP 包本身,而是 Satis 生成的 packages.json —— 它必须包含每个包的 require、conflict、autoload 等字段,Composer 才能递归解析依赖。若恢复的是旧版 Satis 导出的精简元数据(比如只保留 name/version/dist),laravel/framework 在元数据中就“看起来不依赖 illuminate/support”,自然跳过安装。
- 用
curl -s http://your-repo/packagist/packages.json | jq '.packages["laravel/framework"][0].require'直接查元数据是否含require字段 - 对比 Packagist 上同版本的元数据:
curl -s https://repo.packagist.org/p2/laravel/framework.json | jq '.packages["laravel/framework"][0].require',确认字段存在且非空 - 常见丢失场景:Satis 配置里没开
"providers": ["*"]或漏配"require-dependencies": true
如何验证元数据是否可支撑完整依赖解析
光看 JSON 结构合法没用,得验证 Composer 能否真正用它跑通解析流程。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 临时切源:
composer config --no-plugins repo.packagist composer http://your-repo/ - 删干净:
rm -rf vendor composer.lock - 强制重走解析:
composer install --no-cache -vvv 2>&1 | grep -E "(Resolving|requires|Downloading)" - 关键观察点:是否出现
Resolving dependencies through SAT;requires illuminate/support是否被列出;最后下载的包里是否含子依赖
Satis 元数据导出配置必须补全的三项
恢复备份前,先检查并修正 satis.json,否则恢复等于白做。
-
"require-dependencies": true—— 让 Satis 主动读取 VCS 仓库中composer.json的require字段,而非仅靠静态定义 -
"providers": ["*"]—— 启用自动 provider 发现,避免手动维护providers数组时遗漏 -
"archive": {"skip-dev": true, "format": "zip"}必须与"require-dependencies": true同时启用,否则 dev 分支的元数据不会被注入
恢复后必须做的三件事,否则一致性仍是假象
元数据恢复只是起点,真正保证依赖一致要卡住三个环节。
- 运行
composer validate --strict --no-check-publish:确保composer.json语义合规,避免因拼错autoload导致类加载失败 - 检查
composer.lock中所有包的source.type是否为dist(而非git):若含vcs类型,说明它绕过了本地仓库,直接连 GitHub,一致性失效 - 在目标环境执行
composer install --no-dev --prefer-dist后,用composer show --tree | wc -l对比开发机输出行数:差值 > 5 行即存在隐性缺失
元数据恢复最易被忽略的点:Satis 不会自动补全已存包的缺失字段。哪怕你更新了 satis.json,也必须重新 php bin/satis build 全量重建整个 packages.json,旧备份里的残缺条目不会被覆盖或修正。

















