vendor/autoload.php为空是因部分包元数据下载失败导致composer静默跳过错误，表现为文件仅含注释、installed.json残缺或lock文件不完整；应删vendor和composer.lock后重装，并检查镜像配置、清理缓存。
为什么 composer install 后 vendor/autoload.php 是空的
这不是网络彻底断了，而是部分包元数据下载成功、部分失败后 Composer 静默跳过错误，最终生成的 autoload.php 缺少类映射。典型表现是文件存在但只有几行注释，或 composer show 报 Could not find package。
关键判断点：
-
vendor/composer/installed.json为空或结构残缺（比如只有{}或开头就中断） -
composer.lock存在但内容不完整（比如最后几行缺失、JSON 格式错误） - 执行
composer install -vvv时能看到某几个packages.json请求返回 404 或超时，但命令仍“成功”退出
不要试图修复单个文件——直接删掉整个 vendor/ 和 composer.lock，再重装。
镜像源配置写错导致元数据读取失败
配置命令漏参数、URL 少斜杠、键名拼错，都会让 composer config -g repo.packagist 静默失效，Composer 仍走官方源，而你根本不知道。
必须检查三点：
- 命令必须是
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/——repo.packagist不能写成repos.packagist，composer这个 type 值不能省 - URL 末尾必须带
/，否则会拼出类似https://mirrors.aliyun.com/composer/packages.json这样的错误路径 - 运行
composer config -g repo.packagist，输出应为完整 JSON 对象；如果返回null或空，说明没写进去
验证是否真走镜像：执行 composer install -vvv | head -n 10，第一行 URL 必须是你配的镜像地址，不是 packagist.org。
镜像同步延迟引发元数据缺失
新发布的包可能还没同步到镜像站，Composer 查不到 dist URL，就会退回到走 "type": "vcs" 或 "source"，触发直连 GitHub，绕过镜像，导致卡住或失败。
现象：
-
composer install -vvv日志里出现Cloning into '...'或Executing command (CWD): git clone --no-checkout - curl 测试镜像地址返回 404：
curl -I https://mirrors.aliyun.com/composer/p/provider-2026-07%24.json - 临时切回官方源能成功（
composer config -g --unset repos.packagist），说明是镜像延迟而非本地问题
解法不是等，而是换节点或降级目标：
- 阿里云华东节点不稳定时，试中科大源：
composer config -g repo.packagist composer https://packagist.proxy.ustclug.org/ - 若只是部署，用
composer install（非update），它不查最新元数据，只按composer.lock下载已知版本
缓存损坏让元数据“看起来全实则残缺”
Composer 缓存目录里存着压缩包和解析后的 packages.json 片段，一旦中间截断或校验失败，下次读取就拿不到完整元数据，但不会报错。
清缓存不是可选项：
- 先运行
composer clear-cache - Windows 用户额外手动删
%LOCALAPPDATA%\Composer\cache - Linux/macOS 确认
COMPOSER_HOME可写（ls -ld $(composer config -g home)）
别跳过这步——哪怕刚换完镜像，也要清。否则你看到的“重试成功”，可能只是复用了上次损坏的缓存片段。
元数据读取不全的本质，是 Composer 在多个环节（DNS、HTTP、缓存、JSON 解析）中任一环出问题都可能静默吞掉一部分数据，而不是抛出明确错误。所以验证配置、清理缓存、删 lock 文件重来，三步缺一不可。
