Composer报EOF错误本质是解析JSON或zip元数据时读取不完整，主因是镜像同步失败、缓存损坏或dist包下载截断；应先-v定位出错URL，再清缓存、换稳定镜像源（如USTC）、修复文件属主而非盲目chmod。
Composer 报 EOF 错误，基本不是网络断开或磁盘满这种表层问题，而是它在解析某个包的 composer.json、packages.json 或 dist zip 元数据时，读到一半就“没内容了”——本质是缓存/镜像/HTTP 响应体被截断，或本地文件损坏。
EOF 错误常见触发位置和现象
报错通常长这样：file_get_contents(): read of 8192 bytes failed with errno=21 Is a directory（少见但迷惑），或更典型的：cURL error 56: Failure when receiving data from the peer、JSON parse error: unexpected end of data、Failed to decode response: file could not be read。这些都不是 Composer 主动抛的异常，而是底层 PHP 函数（如 file_get_contents、curl_exec）返回空或不完整响应后，Composer 继续往下 parse 导致崩溃。
- 最常发生在
composer update拉取packages.json时（尤其用国内镜像但镜像同步滞后或出错） - 其次出现在解压 dist 包过程中：zip 文件下载不全，
unzip读到半截就 EOF，Composer 却没校验完整性就直接解包 - 极少数是
vendor/autoload.php被截断（比如磁盘突然满、编辑器强制保存失败），导致后续 require 时报ParseError: syntax error, unexpected end of file
先定位是哪一层出的 EOF
别急着删 vendor。先加 -v（verbose）跑一次，盯住最后一行成功输出：
composer update -v
看它卡在哪条 URL 上 —— 是 https://mirrors.aliyun.com/composer/p2/monolog/monolog.json？还是 https://api.github.com/repos/monolog/monolog/zipball/...？或是本地 vendor/composer/installed.json？
- 如果是远程 URL，说明是镜像或网络问题；执行
composer clear-cache后再试 - 如果是本地路径（比如
vendor/composer/installed.json），用head -c 100 vendor/composer/installed.json看结尾是不是乱码或空行；是的话，删掉该文件让 Composer 重生成 - 如果报错指向某个具体包的
composer.json（如vendor/monolog/monolog/composer.json），那大概率是 dist zip 下载不全，删掉整个vendor/monolog/monolog/目录再composer install
换源 + 清缓存是最有效的 EOF 防御手段
EOF 很多时候是镜像源同步失败导致的 packages.json 文件本身就不完整。阿里云、腾讯云等镜像偶尔会因上游中断或自身同步 bug，提供一个开头正常、结尾缺失的 JSON 文件，Composer 解析时直接 EOF。
- 确认当前镜像：
composer config --global repo.packagist - 临时切回官方源验证：
composer config --global repo.packagist composer https://packagist.org - 必须清缓存：
composer clear-cache—— 否则它还在读旧镜像里那个损坏的packages.json快照 - 若确定要换国内源，推荐清华源（同步稳定）：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注：该地址已停用，应改用https://packagist.mirrors.ustc.edu.cn）
EOF 不是权限问题，但 chmod 会把它变得更糟
看到 Permission denied 就加 sudo，结果引发 EOF 类错误——这是典型误操作。因为 sudo composer install 会让部分 vendor 子目录属主变成 root，后续非 root 用户运行时，PHP 可能因无法读取某些缓存文件而返回空内容，最终触发 EOF 解析失败。
- 检查归属：
ls -ld vendor/ composer.lock $(composer config --global cache-dir) - 修复归属（不是权限）：
sudo chown -R $USER:$USER vendor/ composer.lock $(composer config --global cache-dir) - 绝对不要
chmod -R 777 vendor/—— 这会让 autoloader 生成的 PHP 文件变成可执行位，CI 环境可能直接拒绝加载
真正难搞的是那些没进 Git、又没备份的 composer.lock，一旦它被截断，composer validate 会直接报 JSON_ERROR_SYNTAX，这时只能删 lock 重装——但你要清楚，这等于放弃版本锁定，下次部署可能跑不通。
