Pnpm Install报错：无法解析注册表URL

开发者阿泽

2026-6-26

解决semantic-release 15.x版本私有镜像发布URL解析错误问题

问题核心原因

semantic-release 15.x版本对私有registry的URL处理逻辑有变更，大概率是配置中registry地址缺失协议头（http/https），或是包的scope与私有镜像映射规则不匹配，导致生成了无效的相对路径URL。

具体解决步骤

补全registry配置的完整协议头
检查项目根目录.npmrc或全局~/.npmrc，确保私有registry配置是完整的HTTP/HTTPS URL，而非相对路径：
错误写法：@company:registry=/download/
正确写法：@company:registry=https://your-private-registry.com/download/

修正semantic-release的registry配置
若在.releaserc或package.json的release字段中指定了registry，必须配置完整URL：

{
  "plugins": [
    "@semantic-release/npm",
    {
      "npmPublish": true,
      "registry": "https://your-private-registry.com/download/"
    }
  ]
}

校验scope与registry的映射关系
确认package.json的name字段带正确scope（如@company/component），且该scope在.npmrc中已正确映射到私有registry，避免semantic-release错误拼接默认registry路径。
尝试版本兼容调整
若配置无误仍报错，可临时降级到semantic-release 14.x版本验证是否为版本兼容性问题，或升级到15.x最新补丁版本（官方可能已修复该URL解析bug）。
彻底清除包管理器缓存
跨机器执行以下命令清除缓存，避免旧配置残留：
```
# pnpm用户
pnpm cache clean --force
# npm用户
npm cache clean --force
```