换源后仍慢主因是项目级repositories覆盖全局配置、缓存未清或SSL证书过期;须用composer install -vvv | grep "Downloading"验证真实请求域名,且必须执行clear-cache并检查~/.composer/config.json与项目composer.json中的repositories字段。

换源后下载依然慢,大概率不是镜像没切对,而是缓存、配置覆盖或环境限制在暗中拖后腿——必须逐层验证,不能只看 composer config -g repo.packagist 输出了 URL 就算完事。
为什么 composer config -g repo.packagist 显示正确却仍走官方源
这条命令输出正常,不代表请求真发到了镜像站。常见干扰项有:
- 项目根目录
composer.json里定义了repositories字段(哪怕只有一行),它会**无条件覆盖全局配置**;运行composer config --list和composer config --list --global对比,就能看出实际生效的是哪个 -
repo.packagist拼错成repos.packagist(多一个 s):Composer 完全静默忽略,不报错也不 fallback 提示,直接退回到https://packagist.org - URL 末尾缺
/,比如写成https://mirrors.aliyun.com/composer:部分 Composer 版本会拼接出错,导致请求 404 或降级回默认源 - PHPStorm 或 CI 工具调用的是另一个未配置镜像的 Composer 实例(例如宝塔面板自带的、Docker 容器里的、或 PATH 中优先级更高的旧版本)
怎么确认下载请求真发到了镜像站
别信配置输出,要看真实网络行为:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 进项目根目录,执行
composer install -vvv 2>&1 | grep "Downloading",日志里必须出现mirrors.aliyun.com、mirrors.huaweicloud.com这类域名才算真正生效 - 如果看到
packagist.org或api.github.com(某些包直连 GitHub Release),说明镜像被绕过了 - 临时强制指定源测试:
composer install --no-plugins --repository=https://mirrors.aliyun.com/composer/,如果变快,问题就出在本地repositories配置或插件干扰上
换源后还卡在 downloading 的真实原因
镜像只加速「下载」,不解决其他环节的阻塞:
-
Resolving dependencies阶段卡住:和镜像无关,是 PHP 内存不足(memory_limit=128M常见)、启用了xdebug(运行php -v确认)、或composer.lock引用了已下线包导致回溯搜索 - SSL 握手失败:企业内网或老旧 CI 环境(如 CentOS 6)根证书过期,
curl -I https://mirrors.aliyun.com/composer/packages.json返回 SSL error,需升级ca-certificates或临时设composer config -g secure-http false(仅限可信内网) - 缓存污染:换源前的元数据(
packages.json等)还留在~/.composer/cache里,Composer 仍按旧地址去拉取——必须执行composer clear-cache,且之后首次install要带-vvv观察是否重建缓存 - 并发下载未启用:Composer 2.2+ 应设
http-max-concurrent-downloads,不是已弃用的parallel-downloads:composer config -g http-max-concurrent-downloads 10
CI/CD 或内网环境下的特殊处理
公有镜像在封闭环境常因策略受限失效:
- 先手动
curl -I测试镜像可用性,确认是 DNS、HTTPS 还是路径问题 - 若证书校验失败,除升级
ca-certificates外,可加composer config -g secure-http false(仅限内网) - CI 中建议显式组合参数:
composer install --no-dev --prefer-dist --no-autoloader --no-scripts,并确保~/.composer/cache被正确挂载复用 - 阿里云和华为云是目前(2026 年)唯一稳定可用的两个源,清华、腾讯、Laravel China 镜像均已停用或同步延迟严重,别再试旧教程里的地址
最易被忽略的是:换源之后不清理缓存,或者项目里 composer.json 的 repositories 配置长期存在却忘了更新 URL —— 这两类问题占“换源仍慢”案例的七成以上。

















