“file could not be downloaded”或卡在“Loading composer repositories”是网络链路中断导致的元数据拉取失败，需先验证镜像配置（composer config -g repo.packagist输出必须为含末尾斜杠的完整JSON）、清缓存、删vendor和composer.lock后重试。
Composer安装中途报错，绝大多数情况不用重装、不删全局配置，只需根据错误类型针对性清理残留状态并重试——关键在于分清是网络中断、权限错位，还是元数据损坏。
报“file could not be downloaded”或卡在“Loading composer repositories”
这是网络链路中断导致的元数据拉取失败，vendor/ 和 composer.lock 已部分写入但不完整，直接重试会复用旧缓存和错误路径。
- 先确认镜像已生效：
composer config -g repo.packagist输出必须是完整 JSON，且url以https://mirrors.aliyun.com/composer/结尾（末尾斜杠不能少） - 强制清空所有缓存：
composer clear-cache；Windows 用户还需手动删除%LOCALAPPDATA%\Composer\cache\repo - 删掉残缺状态：
rm -rf vendor/ composer.lock（Linux/macOS）或rd /s /q vendor && del composer.lock（Windows） - 验证真实请求地址：
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是实际走的源
报“Permission denied”写 vendor/autoload.php 或 composer.lock
这不是权限不够，而是目录属主被污染成 root，当前用户无权覆盖。常见于误用 sudo composer install 后再用普通用户重试。
- 定位问题路径：报错里明确写出的路径就是目标，比如
file_put_contents(/path/to/vendor/autoload.php)→ 问题在vendor/ - 检查归属：
ls -ld vendor/ composer.lock，若第一列显示root root，即确认所有权错配 - 修复属主：
sudo chown -R $USER:$USER vendor/ composer.lock；若报错涉及~/.composer/cache，同样执行sudo chown -R $USER:$USER $(composer config --global cache-dir) - 别用
chmod 777—— 它不解决属主问题，反而让后续 CI 或部署流程拒绝执行
报“Your requirements could not be resolved”
说明 Composer 已成功连上镜像、下载完元数据，但在本地求解依赖时发现约束冲突。此时删 vendor/ 和缓存毫无意义，重点是看哪个包在拦路。
- 运行
composer why-not php:8.3（把8.3换成你实际要的 PHP 版本），输出会直接指出哪个包锁死了低版本，例如laravel/framework v10.42.0 requires php ^8.1 - 检查
composer.json里是否写了死版本，如"monolog/monolog": "2.9.0"，而新依赖要求^3.0，两者无交集 - 确认 CLI 真实环境：
php -v和php -m | grep -E "curl|openssl|json"，Web 页面的phpinfo()和 CLI 可能加载不同php.ini - 临时绕过（仅调试）：
composer install --ignore-platform-reqs，但上线前必须解决根本兼容性
报“No composer.lock file present”后强行 install 失败
Composer v2.5+ 明确拒绝在无 lock 文件时运行 install，这不是 bug，是设计行为。它不会自动生成 lock，也不会提示“请先 run update”。
- 新项目初始化：必须运行
composer update（不是install），才会解析composer.json并生成合法composer.lock - 误删 lock 后：不要
composer install，直接composer update即可重建 - 若项目已有
composer.lock但报此错，大概率是文件被 Git 忽略或权限丢失，检查ls -l composer.lock是否存在且可读
真正容易被忽略的是项目级 repositories 配置：哪怕 composer.json 里只有一行 "repositories": []，也会彻底屏蔽全局镜像，且不报任何警告。这种情况下，composer config -g 看起来一切正常，但 install -vvv 显示的仍是 packagist.org 地址。
