composer卡死需先运行-vvv看最后几行：停在resolving dependencies是求解器问题，非网络；停在downloading是http层问题；停在executing command是子进程卡死；停在generating autoload files是文件系统问题。
composer install 卡死，换百度云镜像不仅无效，还会让问题更难排查——百度云**没有提供 Composer 镜像服务**，当前（2026年6月）稳定可用的国内镜像只有阿里云、腾讯云、清华大学三个。
卡在 Loading composer repositories 怎么办
这是最常见卡点，本质是 DNS 解析失败或 TCP 连接超时，直连 packagist.org 被阻断所致。
- 执行
composer config -g repo.packagist，确认输出不是null或https://packagist.org - 必须用带
/结尾的 HTTPS 地址，例如：https://mirrors.aliyun.com/composer/（少斜杠会拼出错误 URL） - 项目根目录若存在
composer.json里的repositories字段，会直接覆盖全局配置——哪怕只写了一行"repositories": []，也得删掉或显式设"packagist.org": false - 换源后不执行
composer clear-cache，旧缓存仍会尝试访问packagist.org，日志里照样出现 404 或 TLS timeout
composer install -vvv 停在 Resolving dependencies 怎么办
这不是网络问题，PHP 正在暴力回溯版本组合，和镜像无关。
百度文档解析vlm-parser
下载
调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
- 检查
composer.json是否写了宽泛约束，比如"^1.0 || ^2.0"或"dev-main"引入私有包 - 默认内存限制（1.5GB）常不够，尤其含大量
require-dev包时，临时加大：php -d memory_limit=-1 composer install -
http.timeout对这一步完全无效，调它等于白忙 - Composer 2.9.6 的 SAT 求解器虽有优化，但约束爆炸仍会卡住，可尝试缩小
require范围再逐步放开
Downloading 后无响应，怎么验证镜像真生效了
别只信 config -g 输出，要亲手验证请求是否发到国内地址。
- 运行
composer install -vvv，盯住第一行日志：必须出现Downloading https://mirrors.aliyun.com/composer/packages.json - 手动
curl -I https://mirrors.aliyun.com/composer/packages.json，返回200 OK才算通；返回301或超时说明镜像地址写错或网络策略拦截 - 注意腾讯云当前推荐地址是
https://packagist.proxy.tencent.com/，不是mirrors.cloud.tencent.com子域（后者已不维护） - 清华源地址应为
https://mirrors.tuna.tsinghua.edu.cn/composer/，packagist.phpcomposer.com自 2025 年底起已停服
Executing command 卡住，process-timeout 才管用
这时 Composer 正调用 git clone、unzip 等外部命令，子进程没返回。
-
http.timeout完全无效，必须设process-timeout：composer config -g process-timeout 1200 - CI 环境（如 GitHub Actions）中 exit code 137 表示被 OOM killer 杀掉，需调高容器内存限额
- Windows 下杀毒软件扫描 ZIP 文件会导致假死，加
--prefer-dist可跳过解压环节 - WSL2 中 symlink 解析慢可能卡在
Generating autoload files，非网络问题，得查文件系统性能
-vvv 最后几行，不看输出就动手改配置，90% 是在碰运气。镜像地址写错、缓存没清、项目级配置覆盖、子进程挂起——每个环节都有明确现象和对应动作，盲换“百度云”这种不存在的源，只会掩盖真实原因。
