答案是composer 2.2+已废弃repo.packagist键名，必须用repositories.packagist.org并分两步配置type和url，且url末尾需加斜杠；项目级repositories会完全覆盖全局配置，生效前须执行composer clear-cache。

Composer 配置中文镜像后仍连接失败，90% 是配置未真正生效，而不是网络或镜像站问题——它不会报错，只会静默 fallback 到 packagist.org，然后因 DNS/TLS/CDN 问题卡住或超时。

为什么 composer config -g repo.packagist 看似成功却没用

这条命令在 Composer 2.2+ 中已完全废弃键名兼容性，写进去也静默忽略。真正生效的键是 repositories.packagist.org，且必须分两步设置：type 和 url，缺一不可。

• composer config -g repositories.packagist.org.type composer —— type 值不能省，也不能写成 composer-type 或 packagist
• composer config -g repositories.packagist.org.url https://mirrors.aliyun.com/composer/ —— URL 必须以 / 结尾，少一个斜杠就会拼出 /packages.json 变成 /composerpackages.json，直接返回 404
• 执行后务必验证：composer config -g repositories.packagist.org 应输出完整 JSON 对象，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null 或报错都说明失败

项目级 repositories 字段为什么会屏蔽全局镜像

只要项目根目录的 composer.json 中存在 "repositories" 字段（哪怕值是空数组 [] 或空对象 {}），Composer 就会彻底忽略全局配置，包括你刚配好的 repositories.packagist.org。

Workflow Decomposer

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

下载

• 检查命令：grep -A 5 '"repositories"' ./composer.json，若输出非空，说明已被覆盖
• 临时清掉：composer config --unset repositories（注意没有 -g）
• 安全追加镜像（不破坏私有源）：composer config repositories.packagist.org type composer 和 composer config repositories.packagist.org url https://mirrors.aliyun.com/composer/，前提是 repositories 是对象结构；如果是数组，需先手动改为 "repositories": {} 再运行

怎么确认 Composer 实际请求的是镜像地址

别信日志里 “Loading repository” 这类模糊提示，也别只看 composer config 输出——唯一可靠的方式是看真实 HTTP 请求域名。

• 运行：composer install -vvv 2>&1 | grep "Downloading.*packages.json"
• 第一行输出应类似：Downloading https://mirrors.aliyun.com/composer/packages.json
• 如果出现 packagist.org 或路径错误（如 /composerpackages.json），说明配置未生效或被覆盖
• composer diagnose 不验证镜像连通性，它只连 https://packagist.org，和你配的镜像无关

换源后仍 404 或 SSL 错误，该清理什么

composer.lock 文件硬编码了旧 provider 地址（例如 "https://packagist.org/p2/monolog/monolog.json"），换镜像后 Composer 仍优先尝试这个 URL，失败才 fallback——而新版 fallback 逻辑已被移除。

• 必须删掉：vendor/ 和 composer.lock
• 必须执行：composer clear-cache
• 再重新运行：composer install，否则旧地址缓存仍在起作用
• 某些镜像（如清华源）公网返回 HTML 页面（人机验证），Composer 解析失败；生产环境建议固定用阿里云或腾讯云源：https://mirrors.aliyun.com/composer/ 或 https://mirrors.cloud.tencent.com/composer/

最常被忽略的一点：CI/CD 或 Docker 构建中，composer config -g 写进了 /root/.composer/config.json，但实际运行命令的用户是 www-data 或 runner，根本读不到那个文件——这种情况下，项目级配置 + 提交 composer.json 才是唯一可靠的方案。