必须切镜像源，因国内直连packagist官方源普遍超时或404；阿里云镜像最稳，配置需严格满足三要素：repo.packagist键名、composer类型值、https且末尾带/的url，缺一则静默回退官方源。

国内直接走 Packagist 官方源大概率超时或 404，不是网络问题，而是源本身响应慢或被限流；切镜像源是必须动作，不是可选项。

为什么 composer require 总卡在 downloading？

Packagist.org 官方源在境内访问不稳定，尤其拉大包（如微信/支付宝 SDK 带证书、Guzzle 依赖）时容易中断。这不是你本地网络差，而是 DNS 解析、TLS 握手或 CDN 节点调度导致的普遍现象。

• 阿里云镜像 https://mirrors.aliyun.com/composer/ 稳定性最高，适配 PHP 7.2–8.3 全版本
• 腾讯云镜像 https://mirrors.cloud.tencent.com/composer/ 在华南地区延迟更低
• packagist.phpcomposer.com 已于 2025 年底停止服务，继续配置会 silently fallback 到官方源

怎么切镜像源才真正生效？

全局配置只对新项目起作用，已有项目可能因缓存或 lock 文件残留继续走旧源。必须确认三件事：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意 -g 是全局）
• 进项目根目录，运行 composer diagnose，检查输出里 Repo.packagist: https://mirrors.aliyun.com/composer/ 是否出现
• 删掉 composer.lock 再跑 composer install —— 否则 Composer 仍按 lock 里记录的旧源地址重试

支付宝和微信 SDK 安装失败，镜像源只是第一步

镜像解决的是“下载通道”问题，但支付 SDK 还有更硬的卡点：

• alipay/easysdk：必须用 composer require alipay/easysdk，旧包名 alipay-sdk-php 已废弃，镜像再快也找不到
• wechatpay/wechatpay-guzzle-middleware：这是官方推荐的 V3 SDK 中间件，能直接 require；但主库 wechatpay/wechatpay 未上 Packagist，镜像再快也没用，得手动加 repositories
• 如果提示 Could not find package，先打开 https://packagist.org/packages/alipay/easysdk 确认包存在且支持你的 PHP 版本（比如 v2.3.0+ 要求 PHP ≥ 7.4）

镜像源配置完，不代表 SDK 就能调通——vendor/autoload.php 没引入、密钥格式错、网关地址混用沙箱/正式环境，这些才是后续 90% 的真实拦路虎。