绝大多数Composer下载失败主因是镜像未生效、缓存损坏或OpenSSL扩展缺失；须验证composer config -g repos.packagist输出是否为阿里云地址、执行composer clear-cache、检查php -m | grep openssl是否返回结果。
绝大多数 Composer 下载失败，根本不是网络卡顿，而是镜像没配对、缓存已损坏、或 PHP 扩展缺失——先查这三项，比反复重试快十倍。
确认当前生效的镜像是阿里云（不是“配过”就行）
很多人执行了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就以为搞定了，但实际可能完全没生效：
- 运行
composer config -g repos.packagist（注意是repos，不是repo），输出必须是https://mirrors.aliyun.com/composer/；如果为空、报错或显示其他地址，说明配置失败 - 检查
~/.composer/config.json文件中repositories字段是否正确写入，常见拼写错误是repo.packagist（少个s） - 项目根目录的
composer.json若含repositories段，它会覆盖全局配置；此时要么删掉该段，要么用composer config repo.packagist composer https://mirrors.aliyun.com/composer/改项目级配置
镜像同步滞后导致新包“找不到”
你在 Packagist 上看到 laravel/pint 发了 v1.13.0，但在本地 composer require laravel/pint 报 Could not find package，大概率是镜像没同步：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 打开
https://mirrors.aliyun.com/composer/，看页面底部「最后同步时间」；若超过 2 小时未更新，基本可判定滞后 - 运行
composer show -p laravel/pint，如果返回空，但 Packagist 页面能打开，就是镜像未收录该版本 - 临时切回官方源验证：
composer config --global repo.packagist composer https://packagist.org，再composer require laravel/pint -vvv看是否成功
换镜像后仍卡在 “Downloading … retrying …”？立刻清三样
换源不是万能解药。如果还失败，别反复重试，优先排查底层问题：
- 运行
composer clear-cache—— 缓存里可能存着损坏的 zip 包，不清理会一直复用失败文件 - 运行
php -m | grep openssl，若无输出，说明 OpenSSL 扩展未启用，curl和 HTTPS 下载会静默失败 - 检查是否在宝塔、GitHub Actions 或 GitLab CI 中执行：这些环境不读你的本地全局配置，必须显式写进部署脚本，例如 GitHub Actions 的
run: composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
删 vendor 和 composer.lock 不是首选，但有时必须做
composer.lock 是“安装契约”，硬编码了每个包的下载地址和 SHA256 校验值。换镜像后不删它，Composer 就会执着去旧地址拉包：
- 删之前确认
composer.json已正确合并（尤其团队协作后出现 Git 冲突标记如>>>> HEAD） - 彻底删除
vendor/和composer.lock，再执行composer update --lock重算整棵树 - Windows 下删完仍报
realpath() returned false，很可能是路径含中文或空格，换到纯英文路径重试
真正难处理的不是下载失败本身，而是失败后误判原因——比如把镜像同步延迟当成网络问题，或者把 OpenSSL 缺失当成超时重试就能解决。每次失败，先跑 composer config -g repos.packagist 和 php -m | grep openssl，这两条命令能绕过 80% 的无效排查。
