Composer网络下载问题处理方法-composer-PHP中文网

卡在downloading https://时应调http.timeout，该参数控制dns解析、tls握手、首字节等待及整个body传输的总时间，默认300秒，弱网下易超时，需同步调高php的default_socket_timeout。

composer网络下载问题处理方法

卡在Downloading https:// 时该调 `http.timeout`

这是 HTTP 请求阶段卡住，比如拉 packages.json、下载 ZIP 包，错误里常带 cURL error 28 或反复 retry 后失败。它不看 process-timeout，只认 http.timeout（Composer 2.x）。

http.timeout 控制 DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输的总时间，单位秒，默认仅 300（5 分钟），弱网下极易触发。

项目级最稳：运行 composer config http.timeout 600，写入当前 composer.json 的 config 段，可提交、可复现
全局生效：用 composer config -g http.timeout 600，写入 ~/.composer/config.json
临时覆盖优先级最高：COMPOSER_HTTP_TIMEOUT=1200 composer install，适合 CI 调试

注意：php -i | grep default_socket_timeout 查出的 PHP CLI default_socket_timeout 若低于你设的 http.timeout，会提前掐断连接——常见值是 60，务必同步调高。

`The process timed out` 错误该调 `process-timeout`

这是子进程执行太久被杀，比如 git clone、unzip、跑 post-install-cmd 脚本。错误里一定含 [RuntimeException] The process "" exceeded the timeout，加 -vvv 可看到最后那条命令。

process-timeout 控制单个外部命令最大执行时间，单位秒，默认 300 秒，和 HTTP 完全无关。

全局改：运行 composer config -g process-timeout 1800（30 分钟），写入 ~/.composer/config.json
项目级改：直接在 composer.json 顶层加 "config": {"process-timeout": 1200}
CI 环境建议用环境变量兜底：COMPOSER_PROCESS_TIMEOUT=2000，某些 Composer 版本对它更敏感

设为 0 表示不限时，但不推荐——万一远程 Git 仓库彻底不可达，会无限挂起。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

换镜像比配代理更可靠，优先用 `repo.packagist`

Composer 默认走 HTTPS，多数本地或公司 HTTP 代理不支持 CONNECT 隧道，导致卡在 Downloading https://。镜像源直连 CDN，无隧道依赖，成功率高得多。

国内推荐阿里云镜像：https://mirrors.aliyun.com/composer/，注意 URL 必须以 / 结尾，且 type 必须显式写为 "composer"。

全局配置（确认执行用户）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
项目级配置（CI 更安全）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）
验证是否生效：composer config -g repo.packagist 输出必须是完整 JSON，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；若为空、null 或只返回字符串，说明配置失败

企业内网还必须在 composer.json 根节点加 "packagist.org": false，否则 Composer 仍会先查官方源，私有包永远不被匹配。

`Content-Length mismatch` 先清缓存再重试

这不是 Composer bug，而是 cURL 下载时服务器返回的 Content-Length 头与实际字节数不符，常见于网络中断、CDN 异常或镜像同步滞后。Composer 不支持断点续传，也不会自动修复损坏缓存。

缓存文件一旦写坏（比如只下载了一半），下次安装就会复用并校验失败，重试毫无意义。

第一步永远是 composer clear-cache，确认 ~/.composer/cache/files/ 目录为空后再操作
第二步换镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
第三步加重试：composer install --retry=3；若仍失败，加 --no-cache 强制跳过缓存

手动干预只在反复失败时考虑：从 composer.lock 提取 dist.url，用 wget -c 下载后放进 ~/.composer/cache/files/ 对应 hash 目录——路径和命名必须严格匹配，否则校验失败。