Composer在Jenkins中必须显式调用工作区内的composer.phar，因Jenkins agent不继承系统PATH且环境隔离，依赖全局路径或每次重装均不可靠；需强制校验composer.lock、禁用update、统一缓存与权限配置。
Composer 必须在 Jenkins 执行节点上可调用，且不能依赖本地全局安装路径——否则 composer install 会直接报 command not found。
为什么 composer install 在 Jenkins 里总失败
常见错误是 Jenkins agent 环境里根本找不到 composer 命令。Jenkins 默认不继承系统 PATH，尤其在使用 systemd 启动、或通过 Docker 运行的 agent 上更明显。你手动 SSH 进去能跑通，但 Jenkins 脚本里执行就报错，大概率是环境隔离导致的。
- 别依赖
/usr/local/bin/composer这类路径——不同机器位置不一致，且 Jenkins 可能没权限读 - 不要用
curl -sS https://getcomposer.org/installer | php每次重装——慢、不可控、易被网络拦截 - 推荐方式：把
composer.phar下载到工作区固定位置，然后用php composer.phar install显式调用
如何让 composer.lock 真正起作用
很多人以为只要项目里有 composer.lock，Jenkins 就会自动按锁文件安装——其实不会。默认 composer install 只有在 lock 文件存在且 composer.json 未改动时才严格遵循它；一旦有人改了 composer.json 却没更新 lock，Jenkins 就会悄悄升级依赖，引发线上行为不一致。
- 强制校验锁文件：加
--no-dev --prefer-dist --optimize-autoloader参数，同时确保构建前运行composer validate - CI 中禁用
composer update——除非明确触发“升级依赖”专用 job，否则一律只允许install - 在 pipeline 开头加检查：
if [ ! -f composer.lock ]; then echo "ERROR: composer.lock missing"; exit 1; fi
composer install 的权限和缓存问题
Jenkins 工作空间通常以 jenkins 用户运行，而 vendor/ 目录若之前由 root 或其他用户生成，会导致后续 composer install 报 “Permission denied” 或反复重装。
立即学习“PHP免费学习笔记（深入）”；
- 每次构建前加清理：
rm -rf vendor composer.lock（仅限 dev 环境）或更稳妥地用git clean -fdx - 启用 Composer 全局缓存：在 Jenkins agent 启动脚本里设
export COMPOSER_CACHE_DIR=/var/lib/jenkins/composer-cache，避免重复下载 - 如果用私有 Packagist，必须在 Jenkins 凭据管理中配置 auth.json，并在构建步骤里注入：
composer config --auth http-basic.your-packagist.com $USERNAME $TOKEN
最常被忽略的一点：Jenkins 的 sh 步骤默认使用 /bin/sh，而某些 Composer 插件或自定义脚本依赖 bash 特性。遇到语法错误（比如 [[ 判断失败），别急着改逻辑——先在 sh 步骤开头加 #!/bin/bash 显式指定解释器。
