Nexus OSS从3.46升级至3.47后托管PyPI仓库异常求助

1. 排查版本特定bug #

• 查看Nexus 3.47官方release notes，重点关注PyPI仓库、HTTP连接相关的更新，确认是否为版本引入的已知问题
• 检查Nexus日志（默认路径/sonatype-work/nexus3/log/nexus.log），搜索excessive retries或timeout关键词，定位具体报错细节，判断是代理请求超时还是内部处理瓶颈

2. 调整PyPI仓库的超时与重试配置 #

• 登录Nexus管理后台，找到pypi-all代理仓库：
  • 将HTTP连接超时和读取超时从默认15秒调整为30-60秒
  • 降低重试次数，避免频繁重试导致连接池阻塞
  • 尝试禁用HTTP/2支持，强制使用HTTP/1.1，部分环境下3.47版本的HTTP/2兼容性存在问题

3. 优化Nexus的资源配置 #

• 修改nexus.vmoptions中的JVM堆内存设置：3.47版本对内存需求更高，-Xmx至少设置为4G（可根据实际负载调整），同时调整GC参数减少停顿
• 检查Debian系统资源：用top或htop查看CPU、内存、磁盘IO占用情况，确认是否存在资源瓶颈；用ulimit -n查看文件描述符限制，建议调整至65535以上，保证Nexus可建立足够连接

4. 验证上游仓库连通性 #

• 在Nexus服务器上执行curl -v https://pypi.org/simple/zarr/，测试PyPI官方源的响应时间，确认上游是否存在延迟或故障
• 若上游正常，检查Nexus的代理配置，比如是否使用第三方代理、代理的超时设置是否合理

5. 临时回退或寻找官方补丁 #

• 若以上调整无效，可临时回退至3.46版本，确认问题是否由版本升级导致
• 查看Sonatype的issue tracker，确认是否有其他用户遇到相同问题，是否存在官方补丁或临时解决方案

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