Nexus版本升级后发布新版本致Scope包元数据丢失求助

问题复现 #

• 版本1.0.0发布后可正常访问完整元数据，访问链接：http://nexus/repository/my-nexus-repository/@my-scope%2fpackage-name
• 发布1.0.1版本后，两个版本均失效，访问上述链接仅返回{"_id":"@my-package/package-name"}
• 使用命令发布：npm publish --registry=http://nexus-dev.name.in:8080/repository/repo-name，新包在Nexus中可见但元数据丢失

排查与解决步骤 #

1. 检查新版本package.json的name字段正确性 #

从返回的元数据_id为@my-package/package-name来看，与原包@my-scope/package-name的scope不一致，大概率是1.0.1版本的package.json中name字段写错（将@my-scope误写为@my-package）。

• 打开1.0.1版本的package.json，确认name字段是否为@my-scope/package-name
• 修正后重新发布：先删除Nexus中错误的1.0.1包，再执行原发布命令

2. 重建Nexus仓库元数据 #

如果package.json无误，尝试触发Nexus的元数据重建任务：

• 登录Nexus管理后台，进入目标npm仓库页面
• 点击左侧「Tasks」，创建新任务，选择类型为「Repair - Rebuild npm Repository Metadata」
• 选择目标仓库，执行任务，等待任务完成后重新访问包元数据链接

3. 验证Nexus仓库配置 #

• 检查仓库的「Metadata」配置：进入仓库设置，确保「Enable Metadata」处于开启状态
• 确认发布用的registry与访问用的地址对应：发布命令中的http://nexus-dev.name.in:8080/repository/repo-name和访问链接的http://nexus/repository/my-nexus-repository是否指向同一仓库，若为不同实例需检查同步配置

4. 检查Nexus存储目录权限 #

• 登录Nexus服务器，找到仓库对应的存储路径（默认路径为sonatype-work/nexus3/blobs/<repository-name>）
• 确认运行Nexus的系统用户对该路径拥有读写权限，若权限不足则调整权限后重启Nexus

5. 规范npm发布流程 #

发布带scope的包时，建议先配置scope对应的registry，避免命令行参数出错：

npm config set @my-scope:registry=http://nexus-dev.name.in:8080/repository/repo-name
npm publish

内容的提问来源于stack exchange，提问作者Sagar Dhamani