CI/CD中composer install失败根本原因不是网络问题，而是环境不一致：PHP版本或扩展不满足lock文件要求、platform配置冲突、镜像未生效、缺少composer.lock或vendor被误排除、autoload未正确引入等。
CI/CD 里执行 composer install 却失败，大概率不是网络问题
根本原因在于 composer install 不是“装依赖”，而是按 composer.lock 精确还原环境——它对 PHP 版本、扩展、platform 配置极度敏感，而 CI 环境往往和本地开发机不一致。
- PHP 版本低于
composer.lock中某包要求的最低版本（例如锁了monolog/monolog v3.5.0，它要求PHP >=8.1，但 CI 用的是 8.0） -
ext-mbstring、ext-xml、ext-curl等扩展未启用，composer diagnose会直接标出缺失项 -
composer.json顶部"config": {"platform": {...}}写死了平台版本（如"php": "8.2.10"），但 CI 实际运行在 PHP 8.1 下 - 加了
--ignore-platform-reqs能过安装，但后续运行时大概率报错（比如类找不到、函数不存在），这不是解决，是掩盖
刚 clone 项目就跑 composer install 失败？先看这三件事
不是镜像慢、不是网络差，而是项目交付前就漏掉了关键文件或配置。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.lock文件必须存在且已提交到 Git —— 如果缺失，composer install会 fallback 到update行为，结果不可控 -
vendor/目录是否被.gitignore错误排除？CI 拉不到完整代码树，composer install会因路径冲突或权限问题中断 -
composer.json里是否有拼写错误的包名（比如"laravel/framework": "10.x-dev "多了个空格）？这种错误在 install 阶段不报，但后续autoload会失效
镜像配了却没走，composer install -vvv 才是真相
很多报错看似是“连不上 packagist”，其实是镜像根本没生效，Composer 还在安静地 fallback 到官方源。
- 运行
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是真实请求地址；只看composer config -g repo.packagist输出没用 - 只要项目根目录
composer.json里有"repositories"字段（哪怕只是"repositories": []），全局镜像就彻底失效，不是优先级低，是跳过 - CI runner 或 Docker 容器里可能根本没有
~/.composer目录，你在本地配的全局镜像对它无效；应在 CI 脚本开头显式执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 换源后必须清缓存：
composer clear-cache，否则旧失败记录还在，重试照样走原地址
打包部署时最常被忽略的一点：install 成功 ≠ 能跑起来
composer install 成功只说明 vendor 目录生成了，不代表自动加载、命令注册、环境适配都 OK。
- 类找不到、
php artisan报错、命令不存在，90% 是因为vendor/autoload.php没被正确引入，或autoload映射没生效 -
composer install --no-dev --optimize-autoloader是生产部署唯一安全组合；加--no-dev避免把 PHPUnit 打进镜像，加--optimize-autoloader生成扁平化类映射，提升性能 - 别急着重装——先检查
vendor/autoload.php是否可读，再确认require_once 'vendor/autoload.php'是否在入口文件中被调用，最后用composer dump-autoload -o强制重建映射
