使用ASP.NET Core 对 Azure 应用服务和 IIS 进行常见错误故障排除

本文介绍最常见的错误，并在Azure应用服务和 IIS 上托管 ASP.NET Core应用时提供故障排除建议。

有关常见应用启动错误的信息以及如何诊断错误的说明，请参阅对 Azure 应用服务和 IIS 上的 ASP.NET Core 进行故障排除。

收集以下信息：

• 浏览器行为，例如状态代码和错误消息。
• 应用程序事件日志条目。
  • Azure 应用服务：请参阅对 Azure 应用服务和 IIS 上的 ASP.NET Core 进行故障排除。
  • IIS
    1. 选择 Windows 菜单中的“开始”，键入“事件查看器”，然后按 Enter 。
    2. 打开“事件查看器”后，展开侧栏中的“Windows 日志”“应用程序”>。
• ASP.NET Core 模块 stdout 和 debug 日志条目。
  • Azure 应用服务：请参阅对 Azure 应用服务和 IIS 上的 ASP.NET Core 进行故障排除。
  • IIS：按照 ASP.NET Core 模块文章的 日志创建和重定向和 增强的诊断日志部分中提供的说明进行操作。

将错误信息与以下常见错误进行比较。 如果找到匹配项，请按照故障排除建议进行操作。

本文中的错误列表并不详尽。 如果遇到此处未列出的错误，请使用本文底部的 “内容反馈 ”按钮打开一个新问题，并详细说明如何重现错误。

Important

Azure 应用服务中的 ASP.NET Core 预览版

默认情况下不会将 ASP.NET Core 预览版部署到 Azure 应用服务。 要托管使用 ASP.NET Core 预览版的应用，请参阅将 ASP.NET Core 预览版部署到 Azure 应用服务。

OS 升级删除了 32 位 ASP.NET Core 模块

应用程序日志： 未能加载模块 DLL C:\WINDOWS\system32\inetsrv\aspnetcore.dll。 该数据是个错误。

Troubleshooting:

OS 升级期间不会保留 C:\Windows\SysWOW64\inetsrv 目录中的非 OS 文件。 如果在 OS 升级前已安装 ASP.NET Core 模块，且随后在 OS 升级后在 32 位模式下运行任何应用池，则会遇到此问题。 在 OS 升级后修复 ASP.NET Core 模块。 请参阅 安装 .NET 托管捆绑包。 运行安装程序时，选择“修复”。

缺少站点扩展、安装了 32 位 (x86) 和 64 位 (x64) 站点扩展，或设置了错误的进程位数

适用于 Azure 应用服务托管的应用。

• 浏览器： HTTP 错误 500.0 - ANCM 进程内处理程序加载失败

• 应用程序日志： 调用 hostfxr 以查找进程内请求处理程序失败，未找到任何本机依赖项。 找不到进程内请求处理程序。 调用 hostfxr 捕获的输出：无法找到任何兼容的框架版本。 找不到指定的框架“Microsoft.AspNetCore.App”、版本“{VERSION}-preview-*”。 未能启动应用程序“/LM/W3SVC/1416782824/ROOT”，ErrorCode“0x8000ffff”。

• ASP.NET Core 模块 stdout 日志： 无法找到任何兼容的框架版本。 找不到指定的框架“Microsoft.AspNetCore.App”、版本“{VERSION}-preview-*”。

• ASP.NET Core 模块调试日志： 调用 hostfxr 以查找进程内请求处理程序失败，未找到任何本机依赖项。 这很可能意味着应用程序配置错误，请检查应用程序所针对的 Microsoft.NetCore.App 和 Microsoft.AspNetCore.App 版本，以及这些版本是否已安装在计算机上。 HRESULT返回失败：0x8000ffff。 找不到进程内请求处理程序。 无法找到任何兼容的框架版本。 找不到指定的框架“Microsoft.AspNetCore.App”、版本“{VERSION}-preview-*”。

Troubleshooting:

• 如果在预览运行时运行该应用，请安装 32 位 (x86) 或 64位 (x64) 站点扩展，以匹配应用的位数和应用的运行时版本。 请勿同时安装扩展或扩展的多个运行时版本。

  • ASP.NET Core {RUNTIME VERSION} (x86) 运行时
  • ASP.NET Core {RUNTIME VERSION} (x64) 运行时

  重新启动应用。 等待几秒钟，以便应用重新启动。

• 如果在预览运行时运行应用，且同时安装了 32 位 (x86) 和 64 位 (x64) 站点扩展，请卸载与应用的位数不匹配的站点扩展。 删除站点扩展之后，重新启动应用。 等待几秒钟，以便应用重新启动。

• 如果在预览运行时运行该应用，并且站点扩展的位数匹配应用的位数，请确认预览站点扩展的运行时版本匹配应用的运行时版本。

• 确认“应用程序设置”中的应用“平台”与应用的位数匹配。

有关详细信息，请参阅将 ASP.NET Core 应用部署到 Azure 应用服务。

已部署 x86 应用，但应用池未启用 32 位应用支持

• 浏览器： HTTP 错误 500.30 - ANCM 进程内启动失败

• 应用程序日志： 物理根路径为 '{PATH}' 的应用程序 '/LM/W3SVC/5/ROOT' 遇到意外的托管异常，异常代码= '0xe0434352'。 请检查 stderr 日志以获取详细信息。 物理根路径为 '{PATH}' 的应用程序 '/LM/W3SVC/5/ROOT' 未能加载 clr 和托管应用程序。 CLR 工作线程提前退出

• ASP.NET Core 模块 stdout 日志： 日志文件已创建，但为空。

• ASP.NET Core 模块调试日志： 返回失败的 HRESULT：0x8007023e

在发布自包含应用时，此情景会被 SDK 困住。 如果 RID 与平台目标（例如，win10-x64 RID 与项目文件中的 <PlatformTarget>x86</PlatformTarget>）不匹配，则 SDK 会产生错误。

Troubleshooting:

对于依赖 x86 框架的部署 (<PlatformTarget>x86</PlatformTarget>)，请为 32 位应用启用 IIS 应用池。 在 IIS 管理器中，打开应用池的“高级设置”并将“启用 32 位应用程序”设置为 True 。

平台与 RID 冲突

• 浏览器： HTTP 错误 502.5 - 进程失败

• 应用程序日志：物理根路径为 'C:{PATH}' 的应用程序 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' 未能通过 '"C:{PATH}{ASSEMBLY}.{exe|dll}" ' 命令行启动进程，ErrorCode = '0x80004005 : ff。

• ASP.NET Core 模块 stdout 日志： 未经处理的异常：System.BadImageFormatException：无法加载文件或程序集 '{ASSEMBLY}.dll'。 试图加载的程序的格式不正确。

Troubleshooting:

• 确认应用在 Kestrel 上本地运行。 进程失败可能是由应用的内部问题导致的。 有关详细信息，请参阅对 Azure 应用服务和 IIS 上的 ASP.NET Core 进行故障排除。

• 如果在升级应用和部署更新的程序集时，Azure 应用部署出现此异常，请从先前的部署中手动删除所有文件。 部署升级的应用时，延迟的不兼容程序集可能造成 System.BadImageFormatException 异常。

URI 终结点错误或网站已停止

• 浏览器： ERR_CONNECTION_REFUSED --或-- 无法连接

• 应用程序日志： 没有条目

• ASP.NET Core 模块 stdout 日志： 未创建日志文件。

• ASP.NET Core 模块调试日志： 未创建日志文件。

Troubleshooting:

• 确认正在使用的应用的 URI 端点是否正确。 检查绑定。

• 确认 IIS 网站未处于“已停止”状态。

已禁用 CoreWebEngine 或 W3SVC 服务器功能

OS 异常： 必须安装 IIS 7.0 CoreWebEngine 和 W3SVC 功能才能使用 ASP.NET Core 模块。

Troubleshooting:

确认已启用正确的角色和功能。 请参阅 IIS 配置。

网站物理路径不正确或缺少应用

• 浏览器： 403 禁止访问 - 访问被拒绝 --或者-- 403.14 禁止访问 - Web 服务器被配置为不列出此目录的内容。

• 应用程序日志： 没有条目

• ASP.NET Core 模块 stdout 日志： 未创建日志文件。

• ASP.NET Core 模块调试日志： 未创建日志文件。

Troubleshooting:

检查 IIS 网站的“基本设置”和物理应用文件夹。 确认应用所在的文件夹位于 IIS 网站的物理路径中。

角色不正确、未安装 ASP.NET Core 模块或权限不正确

• 浏览器： 500.19 内部服务器错误 - 无法访问请求的页面，因为该页面的相关配置数据无效。 --或-- 无法显示此页面

• 应用程序日志： 没有条目

• ASP.NET Core 模块 stdout 日志： 未创建日志文件。

• ASP.NET Core 模块调试日志： 未创建日志文件。

Troubleshooting:

• 确认启用了适当的角色。 请参阅 IIS 配置。

• 打开“程序和功能”或“应用和功能”，然后确认是否安装了 Windows Server Hosting。 如果已安装的程序列表中不存在 Windows Server 托管 ，请下载并安装 .NET 托管捆绑包。

  当前 .NET 托管捆绑包安装程序 （直接下载）

  有关详细信息，请参阅 安装 .NET 托管捆绑包。

• 确保 应用程序池>进程模型>Identity 设置为 ApplicationPoolIdentity，或者自定义标识具有访问应用部署文件夹的正确权限。

• 如果卸载了 ASP.NET Core 托管捆绑包并已安装了一个早期版本的托管捆绑包，则 applicationHost.config 文件将不包含 ASP.NET Core 模块分区。 在 %windir%/System32/inetsrv/config 处打开 applicationHost.config 文件，并找到 <configuration><configSections><sectionGroup name="system.webServer"> 分区组。 如果分区组中缺少 ASP.NET Core 模块分区，请添加以下分区元素：

  <section name="aspNetCore" overrideModeDefault="Allow" />
  

  或者，安装最新版本的 ASP.NET Core 托管捆绑包。 最新版本与受支持的 ASP.NET Core 应用向后兼容。

processPath 不正确、缺少 PATH 变量、未安装托管捆绑包、未重启系统/IIS、未安装 VC++ Redistributable 或 dotnet.exe 访问冲突

• 浏览器： HTTP 错误 500.0 - ANCM 进程内处理程序加载失败

• 应用程序日志：物理根路径为 'C:{PATH}' 的应用程序 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' 未能通过 '"{...}" ' 命令行启动进程，ErrorCode = '0x80070002 : 0。 应用程序 '{PATH}' 无法启动。 '{PATH}' 中未找到可执行文件。 未能启动应用程序 '/LM/W3SVC/2/ROOT'，ErrorCode '0x8007023e'。

• ASP.NET Core 模块 stdout 日志： 未创建日志文件。

• ASP.NET Core 模块调试日志： 事件日志：应用程序 '{PATH}' 无法启动。 '{PATH}' 中未找到可执行文件。 HRESULT 返回失败：0x8007023e

Troubleshooting:

• 确认应用在 Kestrel 上本地运行。 进程失败可能是由应用的内部问题导致的。 有关详细信息，请参阅对 Azure 应用服务和 IIS 上的 ASP.NET Core 进行故障排除。

• 检查 web.config 文件中<aspNetCore>元素上的processPath属性，确保对于依赖框架的部署 (FDD)，它为dotnet，对于自包含部署 (SCD)，它为.\{ASSEMBLY}.exe。

• 对于 FDD，可能无法通过路径设置访问 dotnet.exe。 确认“系统路径”设置中存在“C:\Program Files\dotnet\”。

• 对于 FDD，应用池的用户标识可能无法访问 dotnet.exe。 确认应用池用户标识有权访问 C：\Program Files\dotnet 目录。 确认没有为应用池用户标识配置针对 C:\Program Files\dotnet 和应用目录的拒绝规则。

• FDD 可能已部署，并且已安装 .NET，无需重启 IIS。 重启服务器，或通过从命令提示符依次执行 net stop was /y 和 net start w3svc 来重启 IIS 。

• FDD 可能已部署，而无需在托管系统上安装 .NET 运行时。 如果尚未安装 .NET 运行时，请在系统上运行 .NET 托管捆绑包安装程序 。

  当前 .NET 托管捆绑包安装程序 （直接下载）

  有关详细信息，请参阅 安装 .NET 托管捆绑包。

  如果需要特定的运行时，请从 .NET 下载页下载运行时并将其安装在系统上。 重启系统，或通过从命令提示符依次执行 net stop was /y 和 net start w3svc 来重启 IIS，完成安装 。

<aspNetCore> 元素的参数不正确

• 浏览器： HTTP 错误 500.0 - ANCM 进程内处理程序加载失败

• 应用程序日志： 调用 hostfxr 以查找进程内请求处理程序失败，未找到任何本机依赖项。 这很可能意味着应用程序配置错误，请检查应用程序所针对的 Microsoft.NetCore.App 和 Microsoft.AspNetCore.App 版本，以及这些版本是否已安装在计算机上。 找不到进程内请求处理程序。 调用 hostfxr 捕获的输出：是否希望运行 dotnet SDK 命令？ 请从以下位置安装 dotnet SDK：https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409 未能启动应用程序“/LM/W3SVC/3/ROOT”，ErrorCode“0x8000ffff”。

• ASP.NET Core 模块 stdout 日志： 是否希望运行 dotnet SDK 命令？ 请从以下位置安装 dotnet SDK：https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409

• ASP.NET Core 模块调试日志： 调用 hostfxr 以查找进程内请求处理程序失败，未找到任何本机依赖项。 这很可能意味着应用程序配置错误，请检查应用程序所针对的 Microsoft.NetCore.App 和 Microsoft.AspNetCore.App 版本，以及这些版本是否已安装在计算机上。 返回失败的 HRESULT：0x8000ffff 找不到进程内请求处理程序。 调用 hostfxr 捕获的输出：是否希望运行 dotnet SDK 命令？ 请从以下位置安装 dotnet SDK：https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409 HRESULT 失败 返回：0x8000ffff

Troubleshooting:

• 确认应用在 Kestrel 上本地运行。 进程失败可能是由应用的内部问题导致的。 有关详细信息，请参阅对 Azure 应用服务和 IIS 上的 ASP.NET Core 进行故障排除。

• 检查 web.config 中 元素的 arguments 属性，确认该属性：(a) 对于依赖框架的部署 (FDD) 为 <aspNetCore>；或 (b) 对于独立部署 (SCD)，则为不存在、为空字符串 ()，或为应用参数列表 (.\{ASSEMBLY}.dll)。

缺少 .NET 共享框架

• 浏览器： HTTP 错误 500.0 - ANCM 进程内处理程序加载失败

• 应用程序日志： 调用 hostfxr 以查找进程内请求处理程序失败，未找到任何本机依赖项。 这很可能意味着应用配置错误，请检查 Microsoft.NetCore.App 和 Microsoft.AspNetCore.App 版本是否针对该应用程序并安装在计算机上。 找不到进程内请求处理程序。 调用 hostfxr 捕获的输出：无法找到任何兼容的框架版本。 找不到指定的框架 'Microsoft.AspNetCore.App'、版本 '{VERSION}'。

未能启动应用程序 '/LM/W3SVC/5/ROOT'，ErrorCode '0x8000ffff'。

• ASP.NET Core 模块 stdout 日志： 无法找到任何兼容的框架版本。 找不到指定的框架 'Microsoft.AspNetCore.App'、版本 '{VERSION}'。

• ASP.NET Core 模块调试日志： 返回失败的 HRESULT：0x8000ffff

Troubleshooting:

对于依赖框架的部署 (FDD)，确认已在系统上安装正确的运行时。

应用程序池已停止

• 浏览器： 503 服务不可用

• 应用程序日志： 没有条目

• ASP.NET Core 模块 stdout 日志： 未创建日志文件。

• ASP.NET Core 模块调试日志： 未创建日志文件。

Troubleshooting:

确认应用程序池未处于“已停止”状态。

子应用程序包括 <handlers> 部分

• 浏览器： HTTP 错误 500.19 - 内部服务器错误

• 应用程序日志： 没有条目

• ASP.NET Core 模块 stdout 日志： 创建根应用的日志文件并显示正常操作。 未创建子应用的日志文件。

• ASP.NET Core 模块调试日志： 创建根应用的日志文件并显示正常操作。 未创建子应用的日志文件。

Troubleshooting:

确认子应用的 web.config 文件不包含 部分，或者子应用未继承父级应用的处理程序。

在父级应用的 `web.config` 中, <system.webServer> 节被放置在 `<location>` 元素内部。 将 InheritInChildApplications 属性设置为 false，表示在 <location> 元素中指定的设置，不会被驻留在父级应用子目录中的应用继承。 有关详细信息，请参阅用于 IIS 的 ASP.NET Core 模块 (ANCM)。

stdout 日志路径不正确

• 浏览器： 应用正常响应。

• 应用程序日志： 无法在 C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll 中启动 stdout 重定向。 异常消息：在 {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84 返回了 HRESULT 0x80070005。 无法在 C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll 中停止 stdout 重定向。 异常消息：在 {PATH} 返回了 HRESULT 0x80070002。 无法在 {PATH}\aspnetcorev2_inprocess.dll 中启动 stdout 重定向。

• ASP.NET Core 模块 stdout 日志： 未创建日志文件。

• ASP.NET Core 模块调试日志： 无法在 C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll 中启动 stdout 重定向。 异常消息：在 {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84 返回了 HRESULT 0x80070005。 无法在 C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll 中停止 stdout 重定向。 异常消息：在 {PATH} 返回了 HRESULT 0x80070002。 无法在 {PATH}\aspnetcorev2_inprocess.dll 中启动 stdout 重定向。

Troubleshooting:

• web.config 的 stdoutLogFile 元素中指定的 <aspNetCore> 路径不存在。 有关详细信息，请参阅 ASP.NET Core 模块：日志创建和重定向。

• 应用池用户没有 stdout 日志路径的写入权限。

应用程序配置常见问题

• 浏览器： HTTP 错误 500.0 - ANCM 进程内处理程序加载失败 --或者-- HTTP 错误 500.30 - ANCM 进程内启动失败

• 应用程序日志： 变量

• ASP.NET Core 模块 stdout 日志： 日志文件已创建，但为空或使用常规条目创建，直到应用失败。

• ASP.NET Core 模块调试日志： 变量

Troubleshooting:

此进程无法启动，这很可能是由应用配置或编程问题引起的。

如需了解更多信息，请参阅以下文章：

• 对 Azure 应用服务和 IIS 上的 ASP.NET Core 进行故障排除
• ASP.NET Core 项目故障排除和调试