502 Bad Gateway in Azure

This article was translated from English: Does it need improvement?
Translated
View the article in English

502 错误网关 错误是一个 HTTP 状态代码,通常表示网关服务器从另一个服务器接收到错误响应。 关于 IronPDF,当部署到 Azure 时可能会出现此错误。

在本文中,您将找到一些关于如何在 Azure 中解决此错误的建议。

1. 取消勾选“从包文件运行”

在 Visual Studio 中将应用程序部署到 Azure 时,您会看到一个 从包文件运行 选项。 在将应用程序部署到 Azure 之前,请确保取消勾选此选项。 您还可以在应用程序设置中设置 WEBSITE_RUN_FROM_PACKAGE = 0

有关从包文件运行应用程序的更多信息,请参阅微软的官方文档

2. 更改区域

有时,特定 Azure 区域的系统会更新,导致与 IronPDF 冲突。 如果可能,请将应用程序重新部署到另一个区域。

3. 设置为单进程模式运行

在您的代码中,将以下行添加到您的应用程序中并重新部署:

// Set IronPDF to run in single process mode
Installation.SingleProcess = true;
// Set IronPDF to run in single process mode
Installation.SingleProcess = true;
' Set IronPDF to run in single process mode
Installation.SingleProcess = True
$vbLabelText   $csharpLabel

默认情况下,IronPDF 作为多进程软件模块运行,为其接受的任何任务(无论是渲染 HTML,发送 URL 请求等)生成一个新进程。 这使得 IronPDF 具有容错能力,但在受限环境中更难正确运行。 当设置上述选项时,IronPDF 将作为单个进程运行,这将减少其容错能力,但提高库在受限环境中正确运行的可能性。

由于这种“权衡”,我们建议在尝试这项建议之前先尝试以上两个建议。

4. 容器化您的应用程序

为了确保 Azure 系统中的更改不会影响 IronPDF,请使用 Docker 容器化您的应用程序。

您可以通过此链接了解更多关于如何使用 Docker 容器化 IronPDF 的信息。

仍然不起作用?

如果您尝试了上述所有建议并且应用程序仍然抛出 502 错误网关 错误,请通过support@ironsoftware.com联系我们。

To learn how to make a support request, follow this link, and to learn how to retrieve log files from Azure, follow this link.

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外,Curtis 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。

准备开始了吗?
Nuget 下载 16,154,058 | 版本: 2025.11 刚刚发布