Composer 依赖解析中断的四大原因：composer.json 语法错误、composer.lock 损坏、全局配置 ~/.composer/config.json 写坏、vendor/composer/installed.json 损坏，均因 JSON 结构异常导致下游报错而非直接提示文件损坏。

composer.json 语法错误直接中断依赖解析

Composer 在运行 install 前必须完整读取并解析 composer.json，任何 JSON 格式问题都会让后续流程根本无法启动。常见破坏点包括：尾随逗号、单引号代替双引号、注释、未转义的斜杠或 Unicode 控制字符。

• 报错典型表现：Invalid argument supplied for foreach() 或 JSON decode error，且堆栈指向 JsonFile::parseJson()
• 验证方式：用 php -l composer.json 检查语法，或粘贴到 jsonlint.com；别信编辑器高亮——它可能忽略尾随逗号
• 特别注意：某些 IDE 自动生成的 composer.json 会带 UTF-8 BOM，PHP 解析器会静默失败，用 xxd composer.json | head 查看开头是否含 ef bb bf

composer.lock 文件损坏导致版本锁定失效

composer.lock 不是日志，而是精确的依赖快照。一旦内容被截断、校验字段缺失或哈希值错位，install 就会拒绝执行——它宁可失败也不装错版本。

First Principles Decomposer

把任何问题拆解为根本真理，再从原子层面重建解决方案。

下载

• 典型现象：命令卡在 Loading composer repositories with package information 后无响应，或报 file_get_contents(): Failed to open stream: No such file or directory（实际文件存在）
• 原因常是中断写入：CI 流水线超时 kill、磁盘满、编辑器保存时崩溃，导致 composer.lock 变成半截 JSON
• 安全做法：不要手动编辑 composer.lock；若需修复，删掉它再跑 composer install --no-cache，让 Composer 从 composer.json 重生成

全局配置文件 ~/.composer/config.json 被写坏

这个文件控制镜像源、缓存路径、代理等关键行为。如果它格式错误或字段冲突，composer install 可能连第一步都走不下去——比如尝试用 null 当 URL 构造 HTTP 客户端。

• 常见诱因：composer config -g 命令输错参数（如漏掉 composer type）、脚本误写入非法 JSON、权限错误导致写入失败后残留乱码
• 快速诊断：运行 composer config -g --list，若报错或输出为空，基本就是它坏了
• 修复动作：删掉 ~/.composer/config.json（不是清缓存），再重新配镜像：composer config -g repo.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}'

vendor/composer/installed.json 损坏引发 autoloader 失效

这个文件由 Composer 自动生成，记录已安装包的类映射和路径。损坏后不会阻止 install 完成，但后续 php 执行时会报 Class not found 或 Cannot declare class——因为 autoloader 读不到注册信息。

• 触发场景：强制 kill composer install、杀毒软件锁住文件、CI 中复用跨 PHP 版本的 vendor/
• 注意：它不在缓存里，composer clear-cache 对它无效；唯一可靠办法是 rm -rf vendor/ 后重装
• 预防建议：CI 中永远只缓存 ~/.composer/cache，绝不缓存 vendor/；不同 PHP 版本构建必须隔离工作区

配置文件损坏的麻烦在于它不报“文件损坏”，而是把错误转化成下游异常——你看到的是 Class not found、foreach() 错误或连接超时，但根子在 JSON 结构本身。修之前先确认哪一层坏了，别一上来就清整个缓存。