镜像配置未生效主因是repo.packagist键名错误、缺composer类型值或URL末尾无斜杠，任一缺失即静默回退官方源；验证须composer config -g repo.packagist输出完整JSON且含正确URL。
镜像配置写对了，但 composer install 依然卡住、超时或直连 packagist.org——不是网络问题，是配置根本没生效，或者生效了但被其他机制悄悄绕过。
composer config -g repo.packagist 输出为空或仍是 packagist.org
这说明命令压根没写进去，不是“配错了”，而是“根本没配成功”。Composer 对键名、参数顺序、URL 格式三者有硬性要求，错一个就静默失败。
-
repo.packagist必须是单数，写成repos.packagist或repositories.packagist.org全部无效 - 中间的
composer是type值，不能省略，也不是注释——漏掉它，composer diagnose会报Repo is not configured properly - URL 必须以
https://开头，且末尾带斜杠：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致拼出/composerpackages.json404） - 验证是否写入：必须运行
composer config -g repo.packagist，输出应为完整 JSON，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空、null或Key not found就得重试
curl 能通，但 composer install 卡在 Downloading
常见于宝塔面板、Docker 或企业环境，PHP CLI 环境本身就不完整，Composer 启动即崩溃，根本走不到镜像逻辑。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 宝塔默认禁用
putenv、proc_open、pcntl_signal—— 这三个函数一缺，Composer 直接退出，不报错也不提示 - 检查方法：
php -m | grep -E "openssl|tokenizer"，缺模块或报错说明 CLI 环境异常 - 修复步骤：进宝塔「PHP 管理」→ 选版本 → 「禁用函数」页签 → 删除上述三项；再执行软链接（如 PHP 8.0）：
ln -sf /www/server/php/80/bin/php /usr/local/bin/php - Windows 或 WAMP 用户注意：
php.ini中若关闭了allow_url_fopen或openssl扩展未启用，也会导致相同现象
企业高防网络下 TLS 握手静默断连
现象是 composer install 卡住无日志，curl -vI https://mirrors.aliyun.com/composer/packages.json 在 TLS handshake 阶段中断，但浏览器能打开——这不是 DNS 或镜像地址问题，是防火墙（深信服、奇安信等）做了 TLS 内容识别。
- 浏览器信任企业根证书，Composer 默认不信任，握手失败后直接断开，不报具体错误
- 必须显式注入企业 CA：
composer config -g cafile /path/to/company-ca.crt（Linux/macOS 用正斜杠，Windows 用双反斜杠） - 证书导出必须选 PEM 格式（Base64 编码），文件末尾需有换行，不能有 BOM
- 同时确认 UA 没被规则库拦截：部分防火墙会针对
Composer/2.xUA +/packages.json路径组合直接阻断，此时需联系运维调整策略
DNS 解析失败导致请求卡死第一步
Could not resolve host 或 unknown host 不是 Composer 的错，是系统根本查不到 mirrors.aliyun.com 的 IP——所有后续操作都白搭。
- 先验证：
nslookup mirrors.aliyun.com返回Non-existent domain或超时 → 确认 DNS 失效 - 快速验证是否纯 DNS 问题：
curl --resolve "mirrors.aliyun.com:443:223.5.5.5" https://mirrors.aliyun.com/composer/packages.json -I，返回 200 就说明镜像服务正常 - 临时解决：编辑
/etc/hosts（Linux/macOS）或C:\Windows\System32\drivers\etc\hosts（Windows），追加一行：223.5.5.5 mirrors.aliyun.com - CI/CD 或容器环境建议硬绑定 IP，避免 DNS 波动；但注意 Composer 2.5+ 启动时仍会尝试解析原始域名做校验，DNS 彻底不通时 hosts 绑定也未必完全可靠
最常被忽略的是：配置生效 ≠ 请求走镜像。即使 composer config -g repo.packagist 输出正确，项目级 composer.json 中的 repositories 字段、环境变量 COMPOSER_REPO_PACKAGIST、或残留的旧缓存，都会让实际流量绕过你刚配的镜像。
