自建NuGetGallery服务器后Visual Studio包源链接配置求助

一、修复V3包源404问题 #

NuGetGallery默认可能未启用V3端点，或是地址使用错误：

1. 打开站点根目录的Web.config文件，检查是否包含以下配置节点：

   <appSettings>
     <add key="Gallery.V3EndpointEnabled" value="true" />
   </appSettings>
   

   若缺失则手动添加，添加完成后重启站点。
2. 确认正确的V3地址格式：如果你的站点访问地址是https://localhost（带自定义端口的话需补充，比如https://localhost:44300），那么V3包源地址应为https://localhost/v3/index.json。本地部署时容易忽略端口匹配问题，这是导致404的常见原因。

二、解决V2包源看不到已上传包的问题 #

/api/v2/能访问但无法查询到包，绝大多数情况是包的状态问题：

• 登录NuGetGallery的UI后台，找到你上传的包详情页，查看其状态。刚上传的包默认处于**Unlisted（未列出）**状态，这种状态下V2包源不会返回该包。
• 在包详情页点击「List package」按钮，将状态切换为Published（已发布），等待1-2分钟后刷新Visual Studio的包管理器，即可看到目标包。

三、额外排查方向 #

• 检查Visual Studio的包源配置，确保地址无拼写错误（比如多添末尾斜杠、遗漏后缀）。
• 确认服务器防火墙或反向代理规则未拦截/v3/、/api/v2/路径。
• 查看站点App_Data\Logs目录下的日志文件，搜索404或包查询相关的错误信息，定位具体问题根源。

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