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

關於從包檔案運行應用程式的更多資訊,請參閱 Microsoft 的 官方文件

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 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。

準備好開始了嗎?
Nuget 下載 16,154,058 | 版本: 2025.11 剛剛發布