高可用 composer 镜像集群需分离构建、存储、分发三阶段并各自冗余可切换；多 repositories 不等于高可用，因顺序重试无超时感知与失败缓存；satis 仅作静态构建器，dist 包须存 s3/minio，nginx 分发层需健康检查与直链对象存储；禁用 composer_mirror_path_repos，改用全局源配置；须校验 dist 包 sha256 并监听 git tag 触发重建。
直接上结论：高可用 Composer 镜像集群不是“配多个源”就完事的，核心在于分离构建、存储、分发三阶段，并让每个阶段可冗余、可健康检查、可原子切换。
为什么 composer.json 里写多个 repositories 不等于高可用
Composer 的 repositories 列表是按顺序尝试的，一旦某个源返回 404 或 500，它会退到下一个——但这个过程不感知网络超时、DNS 失败或 TLS 握手卡死；更关键的是，它不缓存失败状态，每次 composer install 都重试全部源，拖慢 CI 流程，还可能把私有包请求意外打到公网源上（尤其当 canonical 没设对时）。
常见错误现象包括：
- CI 构建偶尔卡在
Downloading xxx30 秒后失败，日志只显示Connection refused，但没指明是哪个源 - 私有包被误推送到
repo.packagist.org，因配置中漏掉"canonical": false -
composer update在开发机成功，CI 失败——因为开发机有本地缓存，而 CI 容器是干净环境，直连源失败
必须拆开的三个角色：Satis 构建器、对象存储、Nginx 分发层
Satis 本身只是静态生成器，不能当服务进程跑。把它当“编译器”用，而不是“服务器”。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 构建器节点只负责执行
php bin/satis build satis.json web/，输出纯静态文件（packages.json、dist/归档、HTML 页面），不暴露 HTTP 服务 - 所有 dist 包必须上传到共享存储：优先选 S3 兼容接口（如 MinIO），其次 NFS；避免用本地
dist目录，否则多节点间不同步 - Nginx 层做两件事：反向代理请求
/packages.json等元数据（指向构建器输出目录），并用alias或proxy_pass将/dist/xxx.zip请求转给对象存储直链——绕过 Nginx 中转大文件 - 每个 Nginx 节点配置
health_check检查后端对象存储连通性，失败时自动摘除该节点
COMPOSER_MIRROR_PATH_REPOS 是个危险开关
这个环境变量会让 Composer 把本地路径当作镜像源（例如 COMPOSER_MIRROR_PATH_REPOS=/mnt/mirror），但它跳过所有 HTTPS 验证和签名校验，且不支持 require-dev 的条件加载——在企业内网里容易被当成“快速方案”，结果导致安全审计不通过。
真正该用的替代路径：
- 用
composer config --global repos.packagist.org composer https://your-mirror.example.com全局覆盖官方源，比环境变量更可控 - CI 环境中统一注入
COMPOSER_HOME指向预置好 config 的目录，避免污染开发者本地配置 - 禁止在
composer.json里硬编码type: "package"指向本地路径，这会让composer.lock锁定绝对路径，无法跨环境迁移
最容易被忽略的点：dist 包完整性校验与重建触发时机
Satis 默认不校验 dist 包 SHA256，如果对象存储上传中途断开，后续 composer install 可能拉到截断的 zip 文件，报错 ziparchive::extractto(): Invalid or uninitialized Zip object，但错误信息完全不提示是校验失败。
必须做的动作：
- 构建脚本里加一步：对每个生成的 dist 文件运行
sha256sum *.zip > checksums.txt，并把该文件一起上传到对象存储根目录 - CI 触发重建不能只监听
composer.json变更，还要监听私有包 Git Tag 推送（例如用 GitHub Actions 的on: push: tags） - 所有节点的 Nginx 必须启用
add_header ETag "";和expires 1h;，避免客户端缓存过期的packages.json导致拉不到新包
