Jenkins中composer install失败主因是环境未对齐：PATH缺失导致command not found、HOME未设使配置不可用、composer.lock未校验或被忽略、vendor目录权限错误；须显式调用composer.phar、强制校验锁文件、禁用update、设置--no-interaction等参数并修复权限与缓存。
Jenkins 里跑 composer install 失败，90% 不是命令写错了，而是环境根本没对齐——PATH 找不到二进制、HOME 没设、composer.lock 被忽略、权限卡在 vendor/ 目录，四者任一出问题，构建就挂。
composer 命令在 Jenkins 中为什么总报 command not found
Jenkins agent 启动的是非交互式 shell，不读 ~/.bashrc，也不继承你手动配置的 PATH 或 COMPOSER_HOME。它只认系统默认 PATH（通常不含 /usr/local/bin 或 /opt/composer/bin）。
- 别依赖
composer install这种裸调用；必须显式指定路径，比如php /var/lib/jenkins/composer.phar install或/opt/composer/bin/composer install - 更稳的做法：把
composer.phar下载到项目根目录（如./build-tools/composer.phar），Pipeline 里统一用php ./build-tools/composer.phar install - 如果用 Jenkins 全局工具配置 Composer，请确认 tool name（如
my-composer）在 Pipeline 中被tool 'my-composer'正确引用，且该路径下文件存在且可执行
为什么 composer.lock 缺失或未生效会导致线上行为不一致
composer.lock 不是“有就行”，它必须被 Git 提交、被 Jenkins 读到、且不能被 composer install 忽略——否则 Composer 就会按 composer.json 的版本约束重新解析，拉取最新兼容版，跟本地开发完全脱节。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 构建第一步加校验：
if [ ! -f composer.lock ]; then echo "ERROR: composer.lock missing"; exit 1; fi - 禁用
composer update：CI 环境不允许改锁文件，否则下次构建又回到“猜版本”状态 - 本地生成锁文件用
composer lock（不是update），再git add composer.lock && git commit - 确保 Jenkins 构建前没有
git clean -fdx或其他操作意外删掉composer.lock
composer install 在 Jenkins Pipeline 中该加哪些关键参数
裸跑 composer install 在 CI 里等于埋雷：可能卡在交互提示、下载慢、加载 dev 包、autoloader 效率低、甚至因内存不足崩溃。
- 必加
--no-interaction --no-progress --no-dev --optimize-autoloader：跳过所有交互和进度条，不装 dev 依赖，生成高效类加载器 - PHP 内存常不够：加
php -d memory_limit=2G前缀，避免Allowed memory size exhausted - 私有源认证别靠全局
auth.json；用项目级./auth.json并显式传参：--auth-file=./auth.json，且chmod 600 ./auth.json - 如果用了插件（如
hirak/prestissimo），确认其支持当前 PHP 版本；v2 插件不兼容 PHP 7.4，Jenkins 若用旧 PHP 就会静默失败
vendor 目录权限和缓存怎么不踩坑
Jenkins 以 jenkins 用户运行，但上一次构建可能是 root 或其他用户生成的 vendor/，导致本次构建时写入失败，或缓存 key 错误引发依赖错乱。
- 每次构建前清理：
rm -rf vendor（推荐）或更彻底的git clean -fdx（注意别误删重要文件） - 不要盲目缓存整个
vendor/目录：它依赖composer.lock哈希、PHP 版本、平台架构，任意一项变就失效；缓存~/.composer/cache更安全 - 全局缓存路径需显式设置：
export COMPOSER_CACHE_DIR=/var/lib/jenkins/composer-cache，并在 Jenkins agent 启动脚本或 Pipeline 开头声明 - 若复用
vendor/，务必chown -R jenkins:jenkins vendor/，否则后续composer install可能因权限拒绝而重装
最常被忽略的其实是 HOME 环境变量——Jenkins agent 经常没设，导致 Composer 找不到 ~/.composer/ 下任何配置，连 --auth-file 都可能被绕过。加一句 export HOME=/var/lib/jenkins 往往比调半天 PATH 更快解决问题。
