composer_repo_packagist仅在composer≥2.2生效，旧版本（如2.1.x）完全忽略；需验证版本、严格拼写与url格式（全大写、https、结尾/）、检查composer.json是否禁用packagist.org，并同步清空缓存。
COMPOSER_REPO_PACKAGIST 只在 Composer ≥2.2 生效
CI 里设了 COMPOSER_REPO_PACKAGIST 却没走镜像？先运行 composer --version。输出低于 2.2.0 就直接忽略该变量——旧版（比如 php:8.1-cli 自带的 2.1.x）根本不识别它。
升级方案必须绕过包管理器：
- 删掉系统自带的 composer（which composer 查路径）
- 用官方安装脚本： curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
- 验证：composer --version 必须显示 ≥2.2.0
环境变量拼写和 URL 格式错一个就静默失效
COMPOSER_REPO_PACKAGIST 必须全大写、不能少字母，URL 必须以 / 结尾，且协议必须是 https。
正确示例：COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/
常见错误：
- 少结尾斜杠 → 请求变成 https://mirrors.aliyun.com/composer/packages.json，404
- 混入不可见字符（微信/钉钉转发链接常带零宽空格）→ 变量值实际为空
- 写成小写或驼峰（如 composer_repo_packagist）→ 完全不读取
CI 脚本中建议加一行显式验证：echo "Using mirror: $COMPOSER_REPO_PACKAGIST"; composer install
项目禁用了 packagist.org，环境变量自动被跳过
COMPOSER_REPO_PACKAGIST 的作用是“覆盖启用状态下的 Packagist 主源”，不是“强制启用”。如果 composer.json 里有以下任一配置，该变量就完全失效：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"packagist.org": false（显式禁用） -
"repositories": []（清空所有源） -
"repositories": [{"type": "composer", "url": "https://private.repo"}]（未保留 packagist.org）
此时唯一可靠方式是绕过配置逻辑：composer install --repository-url=https://mirrors.aliyun.com/composer/
这个参数优先级最高，连禁用语句都能覆盖。
缓存目录和镜像不绑定，会导致 vendor 不一致
CI 中如果复用 ~/.composer/cache 目录但没同步镜像配置，会出现诡异问题：第一次构建快，第二次慢，甚至报 Class not found。
原因：缓存里存的是旧源（如 repo.packagist.org）下载的包，新镜像无法匹配元数据。
解决方案：
- 每次更换 COMPOSER_REPO_PACKAGIST 值时，必须清空 ~/.composer/cache
- 不要缓存 vendor/ 目录——不同镜像可能返回不同 patch 版本（尤其 composer.lock 未提交时）
- 推荐组合命令：rm -rf ~/.composer/cache && export COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ && composer install
环境变量看似简单，但版本兼容性、拼写容错率低、与项目配置存在隐式优先级冲突——这些点不手动验证，很容易以为配成功了，实际请求还在打国外源。
