Composer install报错时应先看终端末尾红色错误行，捕获Connection refused、curl error 7、Could not resolve host等关键词，确认是否镜像源不可达；执行composer config -g repo.packagist查全局配置，composer config repo.packagist查项目级覆盖，并用composer --debug install -v查看真实HTTP请求路径。
Composer install 报错时如何快速定位镜像源问题
直接看 composer install 或 composer update 失败时终端末尾的红色错误行，重点捕获含 Connection refused、curl error 7、Could not resolve host 或 Repository not found 的输出。这些不是包本身的问题，而是镜像源不可达或配置失效的明确信号。
不要先怀疑自己写的 composer.json —— 如果同一命令在公司内网能跑通、在家不行，大概率是镜像地址写死了国内源但当前网络无法访问。
- 检查是否手动设置了全局镜像：
composer config -g repo.packagist - 确认当前项目是否覆盖了镜像：
composer config repo.packagist（在项目根目录下运行） - 临时绕过镜像验证原始源是否可用：
composer install --repository-url=https://packagist.org
阿里云、腾讯云、华为云镜像返回 404 或 403 怎么办
这些镜像不是永久可用的“服务”，而是定期同步的静态快照站。一旦上游 Packagist 删除某个旧版本包（比如 monolog/monolog v1.23.0），镜像不会回滚，也不会保留已下线包 —— 所以你看到 404 Not Found 很可能只是那个版本被官方撤稿了，而非镜像宕机。
更隐蔽的是 403 Forbidden：腾讯云镜像自 2025 年起对未带 User-Agent 的请求限流；华为云部分节点会拒绝无 Accept 头的 Composer 请求。
- 升级 Composer 到 2.5.8+（修复了 UA 缺失问题）：
composer self-update - 手动补全请求头（仅调试用）：
composer config -g http-basic.repo.packagist.org "" ""不起作用，应改用环境变量：export COMPOSER_REPO_PACKAGIST="https://mirrors.huaweicloud.com/repository/php" - 查证某包是否存在当前镜像中：
curl -I "https://mirrors.aliyun.com/composer/p2/monolog/monolog.json"，看返回状态码
如何让 Composer 输出真实 HTTP 请求路径和响应头
默认日志不显示底层 curl 路径，必须启用 debug 模式并配合 -v（verbose）才能看到实际请求发给了哪个 URL。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
注意：composer -v install 只显示命令级步骤；要看到 HTTP 层，得加 --debug，且必须放在子命令前（顺序敏感）：
composer --debug install -v
输出中搜索 Downloading 或 GET 关键字，你会看到类似：
Downloading https://mirrors.tencent.com/composer/p2/psr/log.json
如果这里地址明显不对（比如指向已停用的 https://packagist.phpcomposer.com），就是配置残留问题。
- 清除所有自定义镜像配置：
composer config -g --unset repos.packagist（全局） +composer config --unset repos.packagist（项目级） - 想保留镜像但临时禁用？用
composer install --no-plugins --repository-url=https://packagist.org，插件类镜像（如composer-asset-plugin）也会被跳过
私有仓库 + 镜像混用时认证失败的典型表现
当你同时配置了私有 GitLab 包仓库和阿里云镜像，Composer 默认会把所有包请求都扔给镜像，包括本该走 SSH 或 Token 认证的私有包 —— 这时你会看到 Failed to download vendor/private-package: No valid credentials provided，但错误位置在下载阶段，容易误判为 token 过期。
根本原因是镜像不代理私有源，而 Composer 没做源路由区分。
- 正确做法：为私有仓库单独声明类型和 URL，并禁用镜像代理：
composer config repositories.private '{"type":"git","url":"git@gitlab.example.com:group/private-package.git"}' - 确保私有仓库 URL 类型为
git或package，而非composer，否则仍会被镜像接管 - 若必须用
composer类型私有源，则需显式关闭镜像对该源的代理："options": {"http": {"proxy": false}}（写在repositories条目里）
composer.json 里的 repositories 块悄悄覆盖了全局设置，而且不报任何 warning。 
