裸写 composer install 在 Jenkins 中会失败，因 agent 环境干净导致全局配置失效、项目级 repositories 屏蔽镜像、composer.lock 依赖旧源；必须配合 --no-dev -o --classmap-authoritative 参数，并每次构建前动态探测阿里云镜像可用性、写入项目级配置、清理 vendor 和 composer.lock 才可靠。
composer install 在 Jenkins 里不能裸写，否则大概率失败或部署不可靠。必须配合参数、镜像、环境控制三者协同，缺一不可。
为什么裸写 composer install 在 Jenkins 里会失败
常见现象是构建卡在 Resolving dependencies 或报 Could not find package，但本地能跑通。根本原因不是网络或命令错，而是：
• Jenkins agent（尤其是 Docker 节点）每次都是干净环境，~/.composer/config.json 写了也白写
• 项目 composer.json 里只要定义了 "repositories": []，全局镜像配置会被完全屏蔽，Composer 直接走 packagist.org
• composer.lock 里记录的包版本可能依赖私有源或已下架版本，没做探测就硬装必然失败
composer install 必须加的三个参数
CI/CD 环境下漏掉任一参数，都可能导致线上类加载失败、性能骤降甚至服务启动报错：
-
--no-dev：跳过require-dev中的包（如phpunit、infection），避免测试工具打入生产环境 -
--optimize-autoloader（可简写为-o）：生成vendor/composer/autoload_classmap.php，绕过 PSR-4 文件扫描，类加载提速 50% 以上 -
--classmap-authoritative：强制只从 classmap 加载类，彻底禁用文件系统扫描，进一步提升稳定性与性能
正确写法示例：composer install --no-dev -o --classmap-authoritative
Jenkins Pipeline 中如何可靠配置阿里云镜像
别信 composer config -g，它在 Jenkins 里基本无效。必须每次构建前，在项目根目录动态写入项目级镜像配置：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先探测镜像可用性：
curl -sfI https://mirrors.aliyun.com/composer/ | head -n 1 | grep "200 OK" - 再执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾带/，且必须指定composertype） - 紧接着清理旧产物：
rm -rf vendor/ composer.lock（确保新镜像生效，避免缓存干扰） - 最后才运行
composer install --no-dev -o --classmap-authoritative
所有操作都在项目根目录进行，不依赖 $HOME，也不受 repositories 字段屏蔽影响。
Webman/Swoole 类项目要额外注意什么
这类项目没有标准构建产物，composer install 是“构建”本身的核心步骤，但容易被忽略环境一致性：
- agent 必须显式指定 PHP 版本标签，例如
agent { label 'php-8.1' }，不能靠自由风格任务默认环境 - 需提前在节点上装好
swoole扩展，否则composer install可能因平台约束失败（如"ext-swoole": "^5.0"） -
config/和.env文件不能由composer install生成，必须在构建后通过rsync或模板替换注入目标环境值
真正容易被忽略的，是镜像探测和项目级 config 写入这一步——不是配一次就完事，而是每次构建前都要重做，否则换镜像源或网络波动时，CI 就会静默退回到慢速、不稳定的官方源。
