答案是默认直连packagist.org导致DNS解析慢、TLS握手失败、TCP超时，而非网络或代码问题；必须配置腾讯云等可用HTTPS全量镜像并加--no-interaction--prefer-dist参数。
上线部署慢，八成卡在 composer install —— 不是代码问题，是镜像没配对。
为什么默认源在生产环境会拖垮部署速度？
Composer 默认走 packagist.org，而这个域名在国内直连极不稳定：DNS 解析慢、TCP 连接超时频繁、TLS 握手失败率高。CI/CD 流水线里反复重试，composer install 动辄 3–5 分钟起步，甚至因超时中断。
- 不是所有“国内镜像”都可用：有些镜像已停服（如阿里云旧版
https://mirrors.aliyun.com/composer/），或仅支持 HTTP（新版 Composer 2.2+ 默认禁用 HTTP 源） - 镜像同步有延迟：packagist.org 新包发布后，镜像通常滞后 10–30 分钟，但绝大多数业务依赖的稳定版本不受影响
- 私有包无法走镜像：若项目用了
repositories自定义 VCS 源（如 GitLab 私仓），镜像配置不会干扰它，无需额外处理
如何安全启用腾讯云 Composer 镜像（推荐）？
腾讯云镜像（https://mirrors.cloud.tencent.com/composer/）目前最稳，HTTPS + 全量同步 + 无认证要求，适配 Composer 2.x 所有版本。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 全局生效（推荐用于 CI/CD 容器）：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
- 项目级生效（适合多项目混用不同镜像）：
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/
- 临时生效（调试用）：
composer install --repository=https://mirrors.cloud.tencent.com/composer/
- 验证是否生效：
composer config repo.packagist应返回{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}
部署脚本里必须加 --no-interaction 和 --prefer-dist
CI/CD 环境没有交互终端，不加 --no-interaction 会导致命令卡住；不加 --prefer-dist 可能回退到耗时更长的 --prefer-source（尤其是镜像未缓存对应 dist 包时）。
- 正确写法：
composer install --no-interaction --prefer-dist --optimize-autoloader
-
--optimize-autoloader必加：生成 classmap 提升运行时性能，且不影响部署速度 - 避免写
composer update上生产：它会重新解析依赖树，触发大量网络请求，应只在开发环境运行 - 如果用了
composer.lock，install是幂等的；没 lock 文件时，部署必然失败 —— 这不是镜像问题，是流程缺陷
遇到 Invalid credentials for private repository 怎么办？
加了镜像后私有包报认证错误，不是镜像惹的祸，而是 Composer 把所有请求都发给了镜像源，连私有仓库也尝试走代理 —— 实际上镜像不会转发私有请求，但 Composer 的 repo 优先级逻辑会干扰。
- 解决方案：显式声明私有源类型为
vcs或package，并确保其url字段是完整 Git 地址（如git@gitlab.example.com:group/project.git） - 检查
composer.json中repositories数组顺序：把私有源放在最前面，packagist 镜像放最后 - 必要时禁用镜像对私有源的影响：
composer config --unset repos.packagist
，再单独配置私有源，但这样就失去镜像加速效果，不推荐
镜像只是加速手段，真正卡点往往藏在 lock 文件缺失、私有源配置错位、或 CI 环境没预装扩展（比如缺少 ext-zip 导致 dist 包解压失败）。先跑通本地 composer install --no-interaction，再挪到服务器，比盲目换镜像更省时间。
