应切换国内镜像源如https://packagist.laravel-china.org并清除缓存，失败时删vendor和composer.lock重装，ci中加健康检查、启用缓存及--prefer-dist参数提升稳定性。
Composer install 时提示 “Connection timed out” 或 “cURL error 28” 怎么办
这是国内用户最常遇到的网络问题，本质是 Composer 默认走 packagist.org（境外源），而该域名在 DNS 解析或 TCP 连接阶段就失败。不是本地网络彻底断了，而是请求被干扰或超时阈值太低。
实操建议：
- 先运行
composer config -g repo.packagist composer https://packagist.phpcomposer.com（已失效，仅作历史参考）——现在应改用composer config -g repo.packagist composer https://packagist.org并配合镜像代理，但更推荐直接切国内镜像 - 立即执行
composer config -g repo.packagist composer https://packagist.laravel-china.org（Laravel China 镜像，稳定且同步及时） - 如果仍失败，临时提高超时：在命令后加
--timeout=300，例如composer install --timeout=300 - 避免在 CI/CD 中硬编码镜像，应通过
COMPOSER_REPO_PACKAGIST=composer=https://packagist.laravel-china.org环境变量注入
为什么 vendor/autoload.php 生成失败，但没报明显网络错误
这往往发生在部分包下载成功、部分失败后 Composer 尝试回滚时。它不会明确告诉你“xx 包因网络中断未写入”，而是静默跳过，最终导致 autoloader 缺少类映射。
判断依据：
- 执行
composer install后，vendor/autoload.php文件存在但为空或只有几行注释 -
composer show报错Could not find package ... in a package repository，说明依赖元数据未完整加载 - 检查
vendor/composer/installed.json是否为空或结构残缺
解决办法：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 删掉整个
vendor/和composer.lock，重新composer install - 不要跳过
composer.lock—— 它锁定的是具体 commit hash，比仅靠composer.json更抗网络抖动 - 若公司内网有缓存代理，确认其支持 HTTP Range 请求（否则大包分片下载会失败）
CI 环境下 Composer install 频繁失败，怎么稳住构建流程
CI 的网络环境通常更受限：DNS 缓存弱、出口 IP 被限频、无交互式重试机制。单纯加大 timeout 不解决问题，得从策略上隔离波动。
关键操作：
- 在 CI 脚本开头加健康检查：
curl -I -s -o /dev/null -w "%{http_code}" https://packagist.laravel-china.org/ | grep -q "200"，失败则 sleep 10 秒后重试，最多 3 次 - 使用
composer install --no-interaction --prefer-dist --optimize-autoloader，禁用 dev 包和源码克隆，减少网络请求数量 - 把
vendor/加进 CI 缓存（如 GitHub Actions 的actions/cache），命中缓存可跳过全部下载 - 若用私有包，确保
auth.json已安全注入，否则认证失败会被当成网络错误掩盖
切换镜像后仍遇到 “Your requirements could not be resolved”
这不是网络问题，而是镜像同步延迟或版本索引不一致导致的误判。packagist.laravel-china.org 一般延迟在 5 分钟内，但某些冷门包或刚发布的 alpha 版可能尚未同步。
应对方式：
- 先运行
composer clear-cache，清除本地可能残留的旧索引 - 用
composer show vendor/package --all查看该包所有可用版本，确认你要的版本是否出现在返回列表中 - 临时切回官方源验证：
composer config -g repo.packagist composer https://packagist.org，如果此时能 resolve，基本确定是镜像同步滞后 - 生产环境不要依赖未同步的开发版；若必须用，可手动下载 tarball 放入
packages/并配置repositories类型为package
镜像不是万能的，它只加速已有索引的包下载。真正脆弱的环节永远在“第一次解析依赖树”——那一步需要完整、一致、低延迟的元数据响应，任何中间环节卡顿都会让 Composer 放弃并报错。
