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

如需進一步了解如何從套件檔案執行應用程式,請參閱 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 Bad Gateway 錯誤,請透過 support@ironsoftware.com 與我們聯繫。

如需瞭解如何提交支援請求,請點擊此連結;如需瞭解如何從 Azure 檢索日誌檔案,請點擊此連結

Curtis Chau
技術撰稿人

Curtis Chau 擁有卡爾頓大學(Carleton University)的電腦科學學士學位,專精於前端開發,並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面,喜歡運用現代框架,並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外,Curtis 對物聯網(IoT)抱有濃厚興趣,致力於探索整合硬體與軟體的創新方法。閒暇時,他喜歡玩遊戲和開發 Discord 機器人,將對科技的熱愛與創意相結合。

準備開始了嗎?
Nuget 下載 19,014,616 | 版本: 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎?

想要快速確認成果嗎? PM > Install-Package IronPdf
執行範例 觀看您的 HTML 轉為 PDF。