Docker 容器部署 ASP.NET Core API 时访问 Swagger 页面的常见问题解答

在 Visual Studio 之外运行 Docker 容器中部署的 ASP.NET Core API 时访问 Swagger 页面的疑难解答

问题

使用 Visual Studio 中的 Docker Compose 功能成功部署了 ASP.NET Core API 项目到 Docker 容器后，在调试期间可以正常访问 Swagger 页面。但是，在停止调试并启动容器后，却无法再访问该页面。

排查步骤

为了解决此问题，需要采取以下排查步骤：

1. 禁用 HTTPS 重定向

即使在代码和启动设置中已禁用 HTTPS，但仍然存在问题。在 Startup.cs 文件中，确保已取消注释以下代码：

app.UseHttpsRedirection();

2. 检查端口映射

验证 Docker Compose 文件中端口映射部分是否正确，如：

ports:
  - "32751:32751"

确保将容器中的端口 32751 映射到了主机的端口 32751。

3. 清除浏览器缓存

浏览器缓存可能会阻止 Swagger 页面加载。尝试清除浏览器缓存并重新加载页面。

4. 检查日志文件

查看 Docker 容器的日志文件，查找任何错误消息或警告，以确定问题的根源。

5. 重新构建 Docker 镜像

尝试重新构建 Docker 镜像，然后重新启动容器，以解决潜在的构建问题。

6. 使用 Kestrel 诊断工具

Kestrel 是 ASP.NET Core 中的 Web 服务器。可以使用 Kestrel 诊断工具来诊断和解决问题。

7. 寻求社区帮助

如果上述步骤无法解决问题，可以寻求 Stack Overflow 或其他技术论坛的社区帮助。

其他提示

• 使用 Visual Studio 中的 Docker Compose 功能，而不是手动运行 docker-compose 命令。
• 禁用浏览器扩展或尝试使用不同的浏览器。
• 确保主机的防火墙允许从容器访问端口 32751。

结论

通过采取这些排查步骤，可以解决在 Visual Studio 之外运行 Docker 容器中部署的 ASP.NET Core API 时无法访问 Swagger 页面遇到的问题。

常见问题解答

1. 为什么禁用 HTTPS 重定向后问题仍然存在？

即使在代码中已禁用 HTTPS 重定向，但 Web 服务器仍可能出于安全原因将其强制实施。

2. 如何使用 Kestrel 诊断工具？

可以在命令提示符下运行以下命令来使用 Kestrel 诊断工具：

dotnet kestrel --diagnostics

3. 社区帮助有哪些可用资源？

Stack Overflow 和 GitHub 等平台提供论坛和讨论区，可以寻求社区帮助。

4. 我应该如何选择要尝试的排查步骤？

按顺序执行排查步骤，从最简单的步骤开始，逐步排除问题。

5. 我如何防止此问题再次发生？

确保在开发过程中始终禁用 HTTPS 重定向，并定期检查端口映射是否正确。