如何修复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为您提供工具 - 您只需要知道在哪里可以找到它们即可。

如果什么都没有起作用，请记住支持的原因是有原因的。当平台本身成为阻止器时，请不要犹豫。

现在您知道该怎么办，您不再卡住了。你有这个。