Jenkins中硬编码composer config -g无效，因其配置不持久且被项目级repositories覆盖；应改用Pipeline脚本动态探测镜像、写入项目级源并验证生效。
直接在 Jenkins Pipeline 里硬编码 composer config -g repo.packagist 是行不通的——它只影响当前 shell 进程，容器重启或 agent 切换后就失效；真要让每次构建都用可用镜像，必须把探测 + 切换逻辑嵌进 Pipeline 脚本里，且得绕开 Composer 自身不 fallback 的限制。
为什么 Jenkins 里写 composer config 常常没效果
Composer 全局配置写入的是容器内用户家目录下的 ~/.composer/config.json，但 Jenkins agent（尤其是 Docker-based 或 ephemeral agent）每次启动都是干净环境，composer config -g 写进去的配置不会持久化到下一次构建。更关键的是：即使配置写对了，只要项目级 composer.json 里有 "repositories" 数组，全局配置就会被完全忽略。
- agent 容器未挂载
~/.composer目录 → 配置每次丢失 - 项目根目录存在
composer.json且含repositories字段 → 全局源被静默屏蔽 - 命令漏掉
composertype 参数或 URL 少末尾/→ 配置写入但无效，composer install仍连packagist.org
在 Pipeline 中动态切换镜像源的实操步骤
核心思路是：每次构建前用 curl 探活镜像地址，成功则设为项目级源，失败则 fallback 到 packagist.org 并显式启用它。所有操作都在项目根目录下进行，不依赖全局配置。
- 先用
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json检查阿里源是否返回200 - 若失败，改用
https://packagist.org，并确保composer.json中"packagist.org": false被移除或设为true - 用
composer config repo.packagist composer $MIRROR_URL/写入项目级配置（注意：不加-g，且 URL 必须带结尾/） - 执行前删掉
vendor/和composer.lock（否则 Composer 会沿用旧 lock 文件里的 dist URL）
避免 repositories 覆盖私有源的关键写法
项目原本用了私有 Git 包（如 "my-vcs": {"type": "vcs", "url": "https://git.internal/pkg"}），直接运行 composer config repo.packagist ... 会清空整个 repositories 对象，导致私有包无法解析。必须手动编辑 composer.json，把镜像源作为数组第一个元素，私有源跟在后面，并显式保留 packagist.org 作为兜底：
{
"repositories": [
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"},
{"type": "vcs", "url": "https://git.internal/pkg"},
{"type": "composer", "url": "https://packagist.org"}
],
"packagist.org": true
}
注意："packagist.org": true 是独立字段，不能塞进 repositories 数组里，否则会被 Composer 当作无效键名忽略。
CI 环境中容易被跳过的验证点
很多团队测完本地 composer install 成功就合入 Pipeline，结果在 Jenkins 上卡住——因为没验证三个隐性条件：
-
composer diagnose输出里必须出现Repo packagist is default（说明当前生效的是你配的镜像，不是 fallback 的官方源） -
composer show --platform | head -n1要能快速返回，证明元数据拉取没超时 -
cat composer.lock | grep -A5 'content-hash'的 hash 值每次构建应一致，若变动，说明镜像源实际没生效，不同构建拉到了不同版本的包
这些检查必须加进 Pipeline 的 pre-steps，不能只靠人眼确认日志里有没有报错。
