如何排查并修复Composer中缺失的文件问题？

本文共计952个文字，预计阅读时间需要4分钟。

如果`vendor/`目录或其中某个包文件丢失，可以直接运行以下命令进行恢复：

vendor/autoload.php 找不到或 require 失败

90% 是路径或入口问题，不是 Composer 没装好。只要 vendor/ 目录存在且 autoload.php 物理文件没被删，问题通常出在：
• 当前工作目录不是项目根目录（即不含 composer.json 的那层），require 'vendor/autoload.php' 会按相对路径找，自然失败
• 在子目录下执行脚本，却没写对 vendor/ 的上溯路径，比如该写 require __DIR__.'/../vendor/autoload.php';
• 手动复制过 vendor/ 到其他项目，但 vendor/composer/autoload_*.php 里写死的是原项目的绝对路径变量（如 $vendorDir），跨目录即失效
• composer install 时加了 --no-scripts，导致自动生成 autoload 的脚本被跳过

composer.lock 损坏导致 install 失败

损坏表现包括：JSON 解析错误、Invalid argument supplied for foreach()、安装后类找不到，或 composer validate 明确报 ./composer.lock is invalid。
• 先用 composer validate 快速确认——它不联网，只校验 JSON 结构和基础字段
• 如果 lock 文件为空、乱码、或 json_decode(file_get_contents('composer.lock'), true) 返回 null，直接删掉它，再跑 composer install，Composer 会按 composer.json 重建一份
• 如果只是部分字段错乱（比如某个包的 dist.sha256 缺失），别手修，风险高；优先试 composer update --lock，它只更新 lock 内容，不动已装包
• 最稳的方式是 Git 回退：git checkout HEAD^1 -- composer.lock，尤其当那个版本曾正常运行过

只想恢复 vendor 下单个被删的包

Composer 没有 reinstall 或 install-package 命令，也不支持“只装某一个”。但可以精准补回：
• 确认 composer.lock 存在且有效
• 删除对应包的整个目录，例如 rm -rf vendor/monolog/monolog
• 运行 composer install —— 它会检查 lock 文件，发现该包缺失，就只下载并解压那个包，其余已存在的包完全不动
• 切忌只删 vendor/monolog/monolog/src/ 这类子目录，Composer 不会识别这种“局部缺失”，install 会直接跳过

composer.json 丢了还能救吗

不能全自动还原，因为 vendor/ 只存代码，不存版本约束、autoload 配置、scripts 等元信息。但可以反推：
• 用 composer show -i 列出所有已装包及精确版本（依赖 composer.lock 存在）
• 打开 vendor/composer/autoload_static.php，搜索 'psr-4' => 或 'files' =>，提取原始命名空间映射（注意把 $vendorDir . '/myapp/src' 转成相对路径 "src/"）
• 区分 require 和 require-dev：看 vendor/bin/ 下有没有 phpunit、phpcs 这类工具，有的话大概率是 dev 依赖
• 补完后必须验证：写个最小测试脚本 require 'vendor/autoload.php'; new \Monolog\Logger('test');，确保类能真正加载

真正容易被忽略的是：Composer 从不主动“修复”你手改坏的文件，它只按声明执行。所谓恢复，本质是重新触发一次受控安装——而控制权全在 composer.json 和 composer.lock 手里。这两个文件一旦出问题，就得靠人工判断+Git 历史兜底，没有一键魔法。