无法在Gemfury私有仓库发布库，遇npm ERR! 503 Service Unavailable错误

我之前帮不少开发者排查过Gemfury私有包发布的问题，遇到npm ERR! 503 Service Unavailable - PUT https://npm-proxy.fury.io/<username>/@<scope>%2f<package-name>这个错误，通常可以从下面几个方向一步步排查：

• 先确认Gemfury服务状态：503错误本质是服务端暂时无法处理请求，很可能是Gemfury正在做维护或者出现了临时故障。你可以先去官方的服务状态页面确认一下（直接在他们官网找status入口即可），如果是全局服务问题，等一段时间再重试就好。

• 检查npm配置的正确性：

  • 先确认你的scope对应的registry是否正确，执行命令：npm config get @<scope>:registry，返回结果应该是https://npm-proxy.fury.io/<username>/，如果不对，用npm config set @<scope>:registry https://npm-proxy.fury.io/<username>/修正。
  • 再检查认证token是否有效，执行：npm config get //npm-proxy.fury.io/<username>/:_authToken，确保这个token是你在Gemfury后台生成的、未过期的有效token。如果token有问题，重新生成一个并更新npm配置。

• 排查网络连接问题：

  • 试试用curl直接请求报错的URL，看能不能正常连通：curl -v https://npm-proxy.fury.io/<username>/@<scope>%2f<package-name>，如果返回超时或者被拒绝，可能是你的网络有代理、防火墙拦截了请求，或者DNS解析有问题。可以切换到手机热点试试，或者检查本地防火墙规则。

• 确认包名和scope的拼写/编码：

  • 仔细核对URL里的<scope>和<package-name>是否和你的包实际名称一致，有没有拼写错误。另外，URL里的%2f是斜杠的转义字符，确认你的包名里的斜杠是否被正确转义了，有时候手动输入或者配置错误会导致路径不对。

• 临时波动的话，多重试几次：如果前面的检查都没问题，那大概率是临时的服务波动，隔个5-10分钟再执行npm publish试试，很多时候这种临时错误会自动恢复。

• 最后求助官方支持：如果以上方法都没用，那就直接联系Gemfury的支持团队，把你的完整错误日志、用户名、包名、发布时间这些信息提供给他们，让他们帮你排查具体的账号或服务端问题。

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