composer本身不支持多节点负载均衡，repositories数组仅线性顺序查找，首个返回200的镜像即被采用，其余完全闲置；所谓“多活”需依赖nginx反向代理+健康检查等基础设施层实现。
Composer本身不支持多节点负载均衡
别指望在 composer.json 的 repositories 数组里写多个镜像地址就能实现“自动负载均衡”——Composer 会按顺序逐个尝试，只用第一个成功响应的源，其余完全闲置。它不并发请求、不健康检查、不按延迟或地理位置路由，更不会在第一个超时后秒切第二个。
常见错误现象：Downloading (connecting) 卡住 30 秒（http.timeout 默认值），然后才退到下一个源；或者第一个镜像 DNS 解析慢、TLS 握手卡顿，整个安装流程就拖长几十秒。
- 禁用默认源后（
"packagist.org": false），后面所有源都形同虚设，只认第一个 - 每个源都会单独请求
packages.json，即使最终没用上，也浪费带宽和时间 - 所谓“多活”，是基础设施层的事，和 Composer 配置无关
Nginx 反向代理 + 健康检查才是可行路径
把多个物理镜像（如阿里云、中科大、腾讯云）统一挂在一个域名下（如 repo.phpmirror.net），由 Nginx upstream 做流量分发，并启用真实有效的健康探测。
关键配置要点：
upstream mirror_backend { server mirror-aliyun.example.com max_fails=2 fail_timeout=30s; server mirror-ustc.example.com max_fails=2 fail_timeout=30s; }- 健康探针必须精准：用
location = /packages.json，返回 200 且Content-Type: application/json，否则 Composer 解析失败但状态码仍是 200，Nginx 不会踢出节点 - 禁用
ip_hash：Composer 并发请求无粘性，会导致某节点过载而其他空闲 - 所有节点静态文件必须完全一致，否则
packages.json里的 ZIP URL 指向不存在路径，下游直接卡死
Satis 私有仓库高可用必须共享存储 + 原子发布
Satis 不是服务进程，只是静态文件生成器。所谓“集群”，本质是让多台 Web 节点托管同一份 packages.json 和 dist/ ZIP 包，靠共享存储（NFS/S3/MinIO）保证一致性。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
容易踩的坑：
- CI 流水线并发执行
satis build到不同机器 → 各节点packages.json内容可能不一致 - 用
rsync直接覆盖线上目录 → 中间态文件导致composer install读到半截packages.json -
archive.prefix-url少了末尾斜杠（如填成https://cdn.example.com/dist而非https://cdn.example.com/dist/）→ ZIP URL 拼接错误，全部--prefer-dist失效，卡在Downloading (connecting) - 没加
"packagist.org": false→ 官方源仍启用，同名包可能被覆盖
客户端配置必须收敛到单一逻辑入口
开发机、CI 环境、Docker 容器不能各自硬编码不同镜像地址。应统一通过环境变量注入，由运维集中管控后端节点变更。
推荐做法：
- CI/CD 中设置
COMPOSER_MIRROR_URL=https://repo.phpmirror.net，而非写死某个 IP 或域名 - 本地开发用
composer config -g repo.packagist composer https://repo.phpmirror.net，避免污染项目级composer.json - 确保该域名能被所有运行环境 DNS 解析通，不能填
localhost或未配/etc/hosts的短名 - 若用 CDN 或对象存储托管 dist 包，必须开启 CORS：
Access-Control-Allow-Origin: *，否则 GitLab Runner + DinD 环境会因跨域拒绝下载
真正难的不是堆机器，而是让所有节点的静态文件原子一致、让健康检查真正反映可服务状态、让客户端永远只看到一个入口。任何环节松动，都会表现为随机卡顿或静默失败，排查起来比代码 bug 还费时间。
