504 Gateway Timeout是反向代理（如Nginx、CDN、公司网关）在等待上游镜像源响应时主动超时返回的HTTP状态码，非Composer自身http-timeout或process-timeout所致；根本解法是换镜像源（如腾讯云）、绕过网关或联系镜像服务商。
Composer 报网关超时（如 504 Gateway Timeout）不是 Composer 自己设的 timeout 触发的，而是上游代理（Nginx、CDN、公司网关）在等待后端响应时主动断开连接——http-timeout 和 process-timeout 都管不到这一层。
看到 504 错误时，Composer 其实还没开始超时逻辑
这个状态码来自反向代理，说明请求已发到镜像源（比如阿里云镜像），但镜像服务响应太慢或卡死，代理等不及就返回了 504。Composer 此时仍在等 HTTP 响应体，它自己的 http-timeout 还没触发（除非你设得比网关还短）。
- 典型现象：
curl: (22) The requested URL returned error: 504 Gateway Timeout或日志里出现504响应头 - 和
curl error 28（超时未收到首字节）完全不同：28 是客户端等不下去了，504 是中间网关先放弃了 - 检查方式：用
curl -v https://mirrors.aliyun.com/composer/packages.json直接复现，看< HTTP/2 504出现在哪一行 - 根本解法不是调 Composer 参数，而是换镜像源、绕过网关、或联系镜像服务商确认可用性
为什么调高 http-timeout 对 504 没用
http-timeout 控制的是 PHP cURL 的 CURLOPT_TIMEOUT，即“从发起请求到收完全部响应”的总时长上限。但网关 504 是在响应流中途就切断 TCP 连接，cURL 会立刻收到 Connection reset by peer 或 Failed to connect to mirrors.aliyun.com port 443 after XXX ms: Connection refused，此时已不属于 http-timeout 的管辖范围。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 即使你把
http-timeout设成 3600，只要网关在 60 秒就返回 504，Composer 就会在 60 秒内失败 - PHP 底层的
default_socket_timeout同样无效——它只影响 socket 建连和读取，不干预已建立连接后被网关中断的情况 - 真正有效的应对是：换源（如切到腾讯云镜像
https://mirrors.cloud.tencent.com/composer/）、加--no-cache避免镜像缓存穿透、或临时禁用代理
process-timeout 完全不参与 504 场景
这个参数只在 Composer 已成功下载 ZIP 包之后才起作用，比如解压、git clone、运行 post-install-cmd 脚本。它对任何 HTTP 请求阶段（包括 504）零影响。
- 如果你看到错误里带
[RuntimeException] The process timed out.，那一定不是 504 引起的 - 504 错误日志里绝不会出现该字符串，只会含
504、Gateway Timeout、Proxy Error等关键词 - 别在 504 时执行
composer config process-timeout 0——这既不解决问题，还会掩盖后续真实子进程问题
怎么快速区分是网关 504 还是本地超时
用 -v + curl 组合验证，别只看 Composer 最终报错文字：
- 运行
composer install -v 2>&1 | grep -E "(504|Gateway|curl error|The process timed out)" - 同时开一个终端跑
curl -v --retry 3 https://mirrors.aliyun.com/composer/packages.json，观察是否稳定返回 200 - 如果
curl直连也报 504，说明是镜像或网络链路问题；如果curl正常但 Composer 报错，再查 Composer 配置（比如repo.packagist.org.url是否拼错） - 国内用户最稳妥的第一步：执行
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，换源比调 timeout 快得多
真正卡在 504 时，Composer 的所有 timeout 配置都只是旁观者。重点不在“设多大”，而在“谁在超时”——网关超时，得找网关的 owner 或换掉它。
