IRONSOFTWAREHOME

502 Azure 中的不良网关

Curtis Chau
Curtis Chau
Updated: 2026年4月24日

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;

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

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

4. 容器化您的应用程序

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

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

仍然不起作用?

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

要了解如何提交支持请求,请按照此 链接,要了解如何从 Azure 中检索日志文件,请按照此 链接。

Curtis Chau
技术作家

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

...
阅读更多

准备开始了吗?

Nuget Downloads 21,105,021版本:2026.9刚刚发布

立即获取您的免费30 天试用密钥。
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中,右键点击引用,管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.9

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中,右键点击引用。选择浏览,“IronPDF.dll”

$999 起

Key in blue circle

立即获取免费的 30 天试用版密钥。

Your trial license will be sent to your email address

无任何限制。100% 解锁。无需信用卡。

OR
bullet_checked无需信用卡或创建账户无任何限制。100% 解锁。无需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
预约您的免费现场演示
Booking Badge

深受全球数百万工程师信赖

Iron Software 的客户徽标
获取您的无义务咨询
填写下面的表格或通过sales@ironsoftware.com
您的资料将始终保密。
深受全球数百万工程师信赖
Iron Software 的客户徽标
立即获取您的免费30 天试用密钥。
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中,右键点击引用,管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.9

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中,右键点击引用。选择浏览,“IronPDF.dll”

$999 起