IRONSOFTWAREHOME

502 Bad Gateway in Azure

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

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;

預設情況下,IronPDF作為一個多處理序軟體模組運行,為其給定的任務(無論是渲染HTML,發送URL請求等)生成一個新的處理序。 這使得IronPDF具有容錯能力,但在有限的環境中較難正常運行。 當設置上述選項時,IronPDF將作為單一處理序運行,這將減少其容錯能力,但會提高其在有限環境中正常運行的可能性。

由於此"權衡",我們建議先嘗試上述兩個建議,再嘗試這個。

4. 將您的應用程式容器化

為確保Azure系統的變更不會影響IronPDF,請使用Docker將您的應用程式容器化。

您可以透過此鏈結了解更多關於如何用Docker容器化IronPDF的資訊。

仍然無法運作?

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

如需了解如何提出支持請求,請參考此鏈結,如需了解如何從Azure檢索日誌檔案,請參考此鏈結。

Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位,專精於前端開發,擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面,喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

...
閱讀更多

準備開始了嗎?

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起