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擁有卡爾頓大學電腦科學學士學位,專長於前端開發,精通Node.js、TypeScript、JavaScript和React。他熱衷於打造直覺美觀的使用者介面,喜歡使用現代框架,並擅長撰寫結構清晰、視覺效果出色的使用者手冊。

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

準備好開始了嗎?
Nuget 下載 17,012,929 | 版本: 2025.12 剛剛發布