如何修復Azure無法啟動Web應用程序錯誤？故障排除指南

您剛剛部署了您的應用程序。一切看起來都不錯……直到您試圖打開它。

什麼都沒有加載。也許您得到了503。也許它只是懸掛。沒有明顯的錯誤，沒有有用的消息。只有您，盯著不會移動的屏幕。

如果您的Azure Web應用程序不會啟動，請不要驚慌。在大多數情況下，它是可以修復的，而且比您想像的要容易。我們將帶您了解發生這種情況的實際原因，並立即提供快速修復的修復程序。

Azure Web應用程序啟動失敗的常見原因

在潛入日誌和高級工具之前，了解通常出了什麼問題是有幫助的。這通常會導致Azure App Service在啟動時失敗：

• 由於代碼不好或丟失文件，應用程序在啟動期間崩潰
• web.config或自定義啟動命令被錯誤配置
• 環境變量（例如秘密或連接字符串）缺失
• 應用程序服務計劃太小，並且無法記憶
• 部署失敗或框架版本與您的應用所需的一個不匹配

了解這些前期會使以下的每一步都更快，更專注。

快速修復無反應的Azure Web應用程序

這些是簡單，即時的動作，通常可以使您的應用程序運行而無需更深入的挖掘：

• 從Azure門戶重新啟動Web應用程序
• 從免費或共享到至少一個基本的應用服務計劃擴展
• 雙檢查web.config或任何用於語法錯誤的自定義啟動腳本
• 將WEBSITE_LOAD_USER_PROFILE設置為應用程序設置中的1 （幫助某些.NET應用程序）
• 恢復到最後一個工作部署或推動新鮮部署
• 在應用程序服務日誌下啟用應用程序記錄
• 嘗試部署到登台插槽，然後交換是否有效

如果問題仍然存在，請繼續。現在我們要具體。

逐步Azure Web應用程序故障排除指南

讓我們以正確的方式進行故障排除。我們將從最簡單的檢查開始，然後更深入，直到達到問題的根源為止。

1。從Azure門戶開始

轉到Azure門戶內的應用程序服務。查看概述選項卡。什麼是應用狀態？

如果說停止，請嘗試單擊“開始” 。如果它停留在“開始”或崩潰到“停止”中，請單擊“診斷和解決問題” 。

該工具可以快速掃描您的應用程序的健康，內存使用情況，配置問題和最近的錯誤。這是快速的，通常是您自己不會發現的標誌問題。

檢查是否有任何資源警報或系統檢測到崩潰循環。

2。檢查日誌流

這是大多數答案的來源。

日誌流啟動時顯示了您的應用程序在做什麼。要查看它，請轉到監視>日誌流，然後重新啟動應用程序。

如果什麼都沒有出現：

• 轉到應用程序服務日誌
• 打開應用程序記錄（文件系統）
• 將日誌級別設置為信息或錯誤
• 保存並重新啟動應用程序

日誌記錄處於活動狀態後，請返回日誌流，然後重試。

尋找以下標誌：

• 啟動後立即崩潰
• 缺少依賴性或導入錯誤
• 環境變量未設置
• 不正確的端口綁定
• main()或啟動方法中的致命例外

那些前10-15個日誌線通常指向根問題。複製任何堆棧跟踪，它們將幫助您解決或搜索更多信息。

3。使用kudu控制台

如果日誌不夠告訴您，請打開Kudu控制台。它使您可以直接訪問應用程序的文件系統和過程列表。

訪問：

單擊調試控制台> CMD 。從這裡：

• 打開D:\home\LogFiles以檢查eventlog.xml和其他崩潰日誌
• 瀏覽D:\home\site\wwwroot確認您的應用程序文件已部署
• 啟動流程資源管理器查看您的應用程序是否正在運行

如果您的過程甚至沒有列出，那麼在很早的啟動過程中可能會失敗 - 在日誌可能會捕獲它之前。這通常意味著不良的配置，損壞的導入或丟失的環境變量。

解決常見的Azure Web應用程序錯誤

這些是人們擊中的最常見錯誤類型。每個人都意味著特定的東西，並為您提供修復的線索。

1。 HTTP500 - 內部服務器錯誤

這意味著Azure啟動了您的應用程序，但是應用程序中的某些內容破裂了。

通常，這是三件事之一：啟動代碼中的崩潰，丟失的依賴性或損壞的路由處理程序。

檢查日誌流以獲取異常。如果您看到錯誤堆棧跟踪指向空值，無效操作或配置綁定失敗，那就是您的罪魁禍首。

在代碼中修復崩潰，再次部署，然後重新啟動應用程序。另外，請確認您在Azure中使用了正確的運行時版本（在一般設置>堆棧下）。

2。 HTTP502或503 - 不可用的網關或服務

當Azure試圖到達您的應用程序但沒有收到任何響應時，就會發生此錯誤。

這意味著您的應用程序沒有綁定到端口，在打開偵聽器之前崩潰或過快的內存用光。

修復：

• 重新啟動應用程序
• 擴展您的應用程序服務計劃以給它更多RAM
• 回顧日誌流以提早出口
• 確保您的啟動命令或web.config啟動應用程序服務器

如果您使用的是節點，請確認您是在正確的端口（ process.env.PORT ）上收聽的。在.NET中，確認您的Program.cs在丟失的配置上不會出錯。

3。沒有狀態代碼 - 永遠“啟動”

這是使大多數用戶感到困惑的沉默失敗：沒有代碼，沒有響應，只是一個卡住的應用程序。

這通常意味著Azure甚至無法啟動您的流程。在日誌或監視之前，某些東西崩潰了。

使用kudu到：

• Open eventlog.xml
• 尋找特定應用的崩潰轉儲
• 驗證您的應用程序文件存在於wwwroot下

在某些情況下，您的部署沒有完成，並且Azure從頭開始。嘗試乾淨地重新部署。如果那不起作用，請回到工作版本。

何時聯繫Microsoft支持Azure Web應用程序問題？

有一點您已經做好了所有操作 - 但是該應用程序仍然無法運行。那是微軟支持應介入的時候。

如果：

您的應用程序不會啟動，日誌不會出現，甚至Kudu控制台也無法正確加載。如果您已經進行了縮放，重新啟動和重新部署，但是沒有任何可行的方法，那麼您可能會遇到只有後端支持才能解決的配額或平台級問題。

確保您在最後幾個部署中收集應用程序名稱，區域，資源組和UTC時間。這有助於支持團隊找到日誌並更快地隔離問題。

如果平台似乎沒有反應，請不要等待太久。 Azure支持可以訪問您看不到的日誌和系統級數據 - 一旦知道發生了什麼故障，它們通常會有所幫助。

防止未來的Azure Web應用程序啟動問題

您可以通過一些簡單的習慣避免大多數啟動問題。這些步驟降低了風險，並在某些事情中斷的情況下向您提供早期警告：

• 始終首先部署到分期插槽- 切勿直接推向生產
• 將web.config ， startup和環境價值保持在版本控制下
• 使用應用程序洞察力並啟用日誌記錄，即使一切都按預期工作。
• 監視應用程序在應用程序服務指標窗格內重新啟動，內存使用和CPU
• 從不硬碼秘密 - 使用應用程序設置安全地管理它們
• 將您的框架版本（Node，.net，Python）與Azure支持的內容匹配

使這些過程的這些部分節省了時間，並防止將來部署中崩潰。

結論

當您的Azure Web應用程序無法啟動時，很容易感到卡住。但是，事實是，問題幾乎總是留下線索 - 在日誌，設置或部署文件中。

通過遵循上面的步驟，您可以弄清楚它為何破裂，自信地修復並重新建造。 Azure為您提供工具 - 您只需要知道在哪裡可以找到它們即可。

如果什麼都沒有起作用，請記住支持的原因是有原因的。當平臺本身成為阻止器時，請不要猶豫。

現在您知道該怎麼辦，您不再卡住了。你有這個。