nexus原生不支持composer协议，必须安装严格匹配版本的nexus-repository-composer插件才能识别packages.json等请求路径；未安装时即使创建proxy仓库并配置https://packagist.org也会返回404或500。
为什么直接配 proxy 仓库无法同步 Composer 包
因为 Nexus 原生不支持 Composer 协议，nexus-repository-composer 插件是硬性前提。没装这个插件时，哪怕你创建了 type=proxy 的仓库、填了 https://packagist.org，Nexus 也只会返回 404 或空响应——它根本识别不了 packages.json、provider-laravel~10.0.json 这类请求路径。
验证方式：用 curl -I http://your-nexus:8081/repository/composer-proxy/p2/laravel/framework/10.0.0.json，如果返回 404 或 500，基本可断定插件未启用。
- 插件必须与 Nexus 版本严格匹配（例如 Nexus 3.87.x 对应
nexus-repository-composer-3.87.0） - 安装后需重启 Nexus 或等待约 60 秒自动加载，不能仅靠 UI 刷新
- 插件启用后，UI 的 “Create repository” 页面才会出现
composer (hosted)、composer (proxy)等新 recipe
如何创建 Composer proxy 仓库并配置阿里云镜像源
别填 https://packagist.org —— 这会导致 Nexus 每次都反向拉取官方源，失去镜像加速意义。正确做法是把 Nexus 当作“二级镜像”，上游设为国内已同步好的 Composer 镜像站。
在 Nexus UI 中创建仓库时：
- Type 选
composer (proxy) - Name 填
composer-proxy（后续 URL 会用到） - Remote storage URL 填
https://mirrors.aliyun.com/composer/（注意末尾/，缺了会 404） - Authentication 保持为空（阿里云镜像无需认证）
- Auto-blocking enabled 建议勾选，防止上游不可用时阻塞请求
创建完不要急着同步：Composer 镜像采用按需拉取机制，首次请求某个 provider 文件时才触发同步，手动点 “Synchronize” 按钮通常无效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
客户端怎么让 Composer 走 Nexus 代理
不是改 composer.json 的 repositories 数组，而是必须用 composer config --global repo.packagist 覆盖元数据源地址。否则 Composer 3.x+ 仍会直连 repo.packagist.org 获取 packages.json 和所有 provider-*.json。
执行以下命令（替换 http://your-nexus:8081 为实际地址）：
composer config -g repo.packagist composer https://your-nexus:8081/repository/composer-proxy/
关键点：
- URL 必须以
/结尾，且协议必须为 HTTPS（若 Nexus 未配 TLS，需先配好或临时用http://+composer config -g secure-http false） - 路径中
/repository/composer-proxy/必须与你在 Nexus 中创建的仓库 name 完全一致（区分大小写） - 运行后立刻验证：
composer config -g repo.packagist应输出完整 JSON：{"type": "composer", "url": "https://..."}
同步失败或类找不到的典型排查步骤
现象：运行 composer install 报 Class 'XXX' not found，但 vendor/autoload.php 存在——这说明依赖没装全，根源常在 Nexus 同步环节。
- 检查 Nexus 日志：
tail -f /opt/sonatype/nexus/logs/nexus.log，搜索ERROR或Failed to fetch - 确认插件状态：
bundle:list | grep composer在 Karaf 控制台里看是否Active - 手动触发一次元数据请求：
curl -v https://your-nexus:8081/repository/composer-proxy/packages.json，看是否返回 200 + JSON - 对比上游镜像：
curl -I https://mirrors.aliyun.com/composer/packages.json，若 Nexus 返回 404 但上游正常，说明插件路由未生效 - 删掉本地
vendor、composer.lock和composer clear-cache，再重试 —— 缓存可能锁死了旧源地址
最易被忽略的一点：Nexus 的 Composer proxy 仓库默认不继承全局 blob store，需在创建时显式选择已存在的 blob store（如 default），否则下载的包文件无法落盘，后续请求全部 404。
