Composer install卡在镜像源请求时，应强制指定可用镜像（如阿里云https://mirrors.aliyun.com/composer/）并关闭自动fallback，而非等待超时；需确保URL末尾带斜杠、清缓存、验证配置生效。
Composer install 时卡在镜像源请求怎么办
直接换源或跳过失效节点，不是等它超时重试。Composer 默认会按 repositories 列表顺序逐个尝试，一旦某个镜像不可达（比如国内某些镜像节点 DNS 解析失败或证书过期），就会阻塞几秒甚至十几秒，尤其在 CI 环境里直接拖垮构建时间。
实操上最有效的是两步：强制指定可用镜像 + 关闭自动 fallback。不推荐用 composer config -g repos.packagist 全局改写，容易污染其他项目。
- 在项目根目录运行
composer config repos.packagist composer https://packagist.org—— 这会把 packagist 镜像设为仅指向官方源（跳过所有第三方镜像） - 或者更常用的是绑定国内稳定镜像：
composer config repos.packagist composer https://packagist.phpcomposer.com（注意：该镜像已停用，应改用https://packagist.laravel-china.org或https://mirrors.aliyun.com/composer/） - 加
--no-plugins参数启动，避免某些插件（如hirak/prestissimo）在旧版中对镜像探测逻辑异常导致卡死
为什么 composer clear-cache 不能解决镜像节点失效
缓存清理只清本地下载包和元数据，不影响 Composer 运行时对远程源的连接策略。失效节点问题出在 repositories 配置或 composer.json 里硬编码的镜像地址，尤其是当配置了多个镜像、且未设置 type: "composer" 或缺少 canonical 标识时，Composer 会尝试所有源，哪怕其中几个早已 502 或 TLS handshake timeout。
- 检查当前生效源：
composer config --list | grep repos - 确认是否启用了
packagist.org的镜像代理模式：输出中若含repos.packagist.type: composer且url指向非官方域名，就说明正在走镜像 - 临时绕过所有自定义源，强制走官方源：运行
composer install --repository=https://packagist.org
composer update 卡在 “Loading composer repositories” 的真实原因
这行日志背后是 Composer 正在并发请求每个 repositories 条目下的 packages.json（通常是 https://xxx.com/packages.json）。只要有一个返回慢、超时或返回空响应（比如 Nginx 返回 200 但 body 为空），整个流程就会 hang 住，且默认无超时中断机制。
- 用
COMPOSER_MEMORY_LIMIT=-1 COMPOSER_DISABLE_TTY=1 composer update -v加详细日志，看卡在哪条 URL - 若发现某镜像域名解析失败（如
getaddrinfo failed），可临时修改/etc/hosts绑定 IP，或改用 IP 直连（如https://123.56.78.90/composer/）测试是否 DNS 导致 - 阿里云镜像需注意路径结尾必须带斜杠：
https://mirrors.aliyun.com/composer/❌ 错误写法是https://mirrors.aliyun.com/composer（少斜杠会导致 301 跳转，部分版本 Composer 不处理重定向）
CI 环境下如何确保镜像还原稳定可靠
CI 容器每次都是干净环境，不能依赖本地 config 设置。必须在命令链路中显式控制镜像行为，否则不同 runner 可能因缓存或网络策略差异表现不一致。
- 在
composer install前插入：composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/ - 禁用 packagist 自动发现（防 fallback）：
composer config --global packagist false - 若项目
composer.json中已有repositories块，CI 中优先用--no-plugins --no-scripts启动，避免插件干扰源解析逻辑
最易被忽略的一点：某些私有镜像服务（如 Nexus、Artifactory）在开启 HTTPS 但证书不可信时，Composer 不报错也不跳过，而是无限等待——此时必须配 composer config --global secure-http false，并确保你清楚安全代价。
