私有仓库 git tag 同步失败主因是 composer.json 中存在 version 字段，需彻底删除该行、确保 type 字段合法、使用带 v 前缀的轻量 tag；多活场景下应避免 repositories 数组堆砌镜像，改用反向代理统一入口实现自动故障切换与负载均衡。
私有仓库 Git tag 不同步？先删 version 字段
私有包打完 git tag v1.2.0 后 composer require 找不到，90% 是因为根目录 composer.json 里写了 "version" 字段。Composer 一旦看到这个字段，就直接忽略 Git tag，只认硬编码值——哪怕你写了 "1.2.0"，它也会报 Could not find a matching version of package。
必须做三件事：
- 整行删除
"version": "x.x.x"（不是留空，是彻底移除） - 确保
"type"字段存在且合法，例如"type": "library" - 用带
v前缀的轻量 tag：git tag v1.2.0 && git push origin v1.2.0
多活数据中心间元数据不一致？别靠 repositories 数组“堆镜像”
在项目 composer.json 的 "repositories" 里写多个私有 VCS 地址（比如华东 GitLab、华南 GitLab），并不能实现跨中心自动切换或负载均衡。Composer 按数组顺序逐个尝试，只用第一个可用源，其余完全闲置；它不并发、不健康检查、不按延迟路由。
强行堆砌会引入副作用：
- 每个源都单独请求
packages.json，哪怕只用第一个，其余请求仍发出，浪费带宽且拖慢首次安装 - 不同中心 Git 仓库同步延迟不同（如华东 30 秒、华南 2 分钟），导致同一
composer update在不同机器上解析出不同版本 - 若任一中心不可达，Composer 会卡满
http.timeout（默认 30 秒）才 fallback，而非秒级切流
真正可行的多活方案：用反向代理统一入口
让 Composer 客户端无感使用多活私有仓库，关键在于把多个物理 Git 实例抽象成一个逻辑地址，由基础设施层完成流量分发与故障隔离。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
推荐落地方式：
- 自建
Nginx反向代理集群，上游配置多个 GitLab 地址，启用health_check和least_conn，对/api/v4/projects/{id}/repository/tags等关键路径主动探活 - 用
composer-proxy（Go 实现）启动本地服务监听127.0.0.1:8080，内部轮询华东/华南 GitLab，失败自动降级，再通过COMPOSER_REPO_PACKAGIST=http://127.0.0.1:8080注入 - CI/CD 中禁用 fallback：在
composer.json根节点加"packagist.org": false，并显式指定代理地址：composer install --repository=http://proxy.internal.com/composer/ --no-cache
composer update --refresh 失效？确认生效源是否被劫持
composer update --refresh 只在 Composer ≥ 2.5 有效，但它只会从“当前实际生效的源”拉取元数据——而这个源常被项目级配置静默覆盖。
排查步骤：
- 运行
composer config --list | grep repositories.packagist.url，输出为空说明项目composer.json里的"repositories"完全屏蔽了全局设置 - 检查
composer.json是否含"type": "vcs"，不是"package"或"path"——后者不支持 tag 解析 - 确认 URL 可访问：
curl -I https://gitlab-sh.internal.com/api/v4/projects/123/repository/tags必须返回HTTP/2 200 - 老版本（≤ 2.4）不支持
--refresh，只能手动删缓存：rm -rf $(composer config --global cache-dir)/repo/https---gitlab-sh-internal-com
多活设计中最容易被忽略的点：Git 仓库本身的数据同步（如 tag 推送）和 Composer 元数据缓存刷新是两个独立环节，不能只调一端。华东中心推了 tag，但华南中心的 Git 镜像没同步完，或者 Composer 客户端还在读本地过期的 packages.json，都会导致“明明打了 tag 却装不上”。
