Composer镜像配置失效主因是命令错误、被覆盖或源不可用；composer config -g repo.packagist需严格满足四条件：拼写准确、type参数必填、URL以/结尾、必须加-g；否则静默回退至packagist.org。
镜像配不生效，90% 是命令写错、被覆盖或源本身不可用，不是 Composer 问题。 它根本不会自动 fallback，也不支持多个同类型源并存——写错一个字符，就静默走回 packagist.org。
composer config -g repo.packagist 命令为什么总失败
这条命令必须严格满足四个硬性条件，缺一不可：
-
repo.packagist不能拼成repos.packagist（多一个 s 就无效）、也不能是packagist.org或mirror - 第三个参数
composer是 type 值，不是可选注释——漏掉它，Composer 2.x 会直接忽略整条配置 - URL 必须以
/结尾，比如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/packages.json错误路径，返回 404 - 必须加
-g，否则只改当前项目目录下的composer.json，换个项目就失效
验证是否写入成功：运行 composer config -g repo.packagist。正确输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；如果返回空、null 或报错，说明没写对。
明明配了却还是走 packagist.org
不是配置没保存，而是被更高优先级的设置覆盖了。Composer 的源优先级是：项目级 composer.json 中的 repositories > 全局配置 > 默认源。
- 进项目目录后执行
composer config repo.packagist，如果输出 URL，说明项目级已覆盖全局 - 检查
composer.json是否含"repositories": []或"repositories": {}——哪怕空数组也会屏蔽全局镜像 - CI/CD 流水线里常有人误加
"packagist.org": false，结果连基础包都拉不到 - Docker 构建时，
composer config -g写进了容器临时/root/.composer，但构建用户是www-data，根本读不到
最准的验证方式是加 -vvv 跑一次：composer install -vvv | grep "Downloading.*packages.json"，看实际请求的域名是不是你设的镜像地址。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
curl 测试镜像源连通性时常见错误
缓存清了、命令也对了，但 composer install 还是卡在 Loading composer repositories ——这时问题大概率出在 TLS 或 DNS 层，不是 Composer 配置问题。
- 手动测源：运行
curl -I https://mirrors.aliyun.com/composer/packages.json，必须返回HTTP/2 200；若返回301（说明用了 HTTP 地址）、timeout（DNS 或网络不通）、或SSL certificate problem（系统 CA 不信任该镜像证书），Composer 就会卡住 - 某些企业网络拦截非标准证书链，可临时调试：
curl -kI https://mirrors.aliyun.com/composer/packages.json，但生产环境绝不能关证书验证 - 腾讯云镜像
https://mirrors.cloud.tencent.com/composer/在部分运营商网络下 DNS 解析慢，阿里云目前稳定性更好
别忘了镜像服务本身可能失效：淘宝镜像早在 2022 年就下线，清华源公网访问有时触发人机验证，华为云路径是 https://repo.huaweicloud.com/repository/php/，不是 /composer/。
CI/CD 和 Docker 环境下镜像配置失效
这些环境没有持久化的用户家目录，composer config -g 写的配置无法跨构建保留，每次 composer install 都走默认源。
- Dockerfile 中不要依赖
~/.composer/config.json，改用ENV COMPOSER_HOME=/tmp/composer+RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - GitHub Actions 等平台建议缓存
~/.composer目录，否则即使配置了，下次构建仍可能走慢源 - 更稳妥的做法是在
composer.json里声明repositories字段——虽然不算“全局”，但能确保所有构建行为一致，且可被 Git 跟踪 - 临时切源排查问题，用
--repository-url=https://mirrors.aliyun.com/composer/，它优先级最高，但只对当次install或update有效
真正容易被忽略的是：镜像配置只是告诉 Composer “去哪找 packages.json”，后续下载 dist 包、解析依赖、校验 hash 都还依赖网络质量、PHP 版本兼容性、以及 lock 文件里已锁定的源信息——旧 composer.lock 可能仍指向 packagist.org 的元数据，删掉再重装才真正切换。
