Azure 中的 502 Bad Gateway 錯誤

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

502 Bad Gateway錯誤是一個 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;
$vbLabelText   $csharpLabel

預設情況下, IronPDF會作為多進程軟體模組運行,為它被賦予的任何任務(無論是渲染 HTML、發送 URL 請求等)產生一個新進程。 這使得IronPDF具有容錯能力,但在資源受限的環境中不太可能正常運作。 設定上述選項後, IronPDF將作為單一進程運行,這將降低其容錯能力,但會提高庫在受限環境中正常運行的可能性。

鑑於這種"權衡",我們建議您先嘗試以上兩種建議,然後再嘗試這種方法。

4. 將應用程式容器化

為確保 Azure 系統中的任何變更不會幹擾IronPDF,請使用Docker將應用程式容器化。

您可以點擊此連結了解更多關於如何使用Docker將IronPDF容器化的資訊。

還是不行?

如果您已嘗試以上所有建議,但您的應用程式仍拋出502 Bad Gateway錯誤,請透過support@ironsoftware.com與我們聯絡。

若要了解如何提出支援請求,請點擊此連結;若要了解如何從 Azure 檢索日誌文件,請點擊此連結

Curtis Chau
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

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

準備好開始了嗎?
Nuget 下載 17,803,474 | 版本: 2026.3 剛剛發布
Still Scrolling Icon

還在滾動嗎?

想快速取得證據? PM > Install-Package IronPdf
運行範例看著你的HTML程式碼變成PDF檔。