Azure 应用服务上的 500.31 ANCM 故障排除

Question

将项目从ASP.NET Core 3.0升级到ASP.NET Core 3.1后，我的应用程序停止在Azure App Services上工作——但仅当使用来自Azure DevOps Pipelines的持续部署发布时。 （ 与另一个问题类似，如果我直接从 Visual Studio 发布，它会继续工作。）

具体来说，管道仍然能够使用Azure 应用服务部署( AzureRmWebAppDeployment ) 任务进行发布，但无法在 Azure 应用服务环境中加载，出现500.32 异常：

500.31 ANCM 找不到原生依赖

此问题的常见解决方案：

找不到指定版本的 Microsoft.NetCore.App 或 Microsoft.AspNetCore.App。

现在，对于未安装 .NET 运行时的情况，我非常熟悉此错误，这在 Microsoft 发布新版本后立即很常见。 在这些情况下，典型的解决方案是：

1. 作为应用程序的--self-contained版本发布，或者发布到
2. 启用适当的运行时作为App Service Extension （如果可用）。

在这种情况下，我知道.NET Core 3.1.2 运行时在 App Services 环境中可用，并且还确认这些解决方案无法解决问题。 这表明存在不同的潜在错误。

其他线程建议在 Windows 事件查看器（以及此处）中查找这些详细信息。 由于这是一个 Azure 应用服务，我反而查看了应用服务日志。 那些只包含上述错误的副本，但是没有任何进一步的详细信息。 此外， Azure Application Insights中没有记录任何异常，表明此错误发生在 Application Insights 加载之前。

鉴于此，我的问题是：如何解决 Azure 应用服务上的 500.31 错误？

Answer 1

应用服务日志与Windows 事件查看器不同； 它们将捕获异常，并且对于排除您没有看到的错误很有用，但它们至少不会产生关于 ANCM 错误的附加信息。 相反，您需要确保启用详细错误，以确保您还获得ANCM 检测到的特定错误。

启用详细错误

在 ASP.NET Core 应用程序中，可以使用Startup类中的UseDeveloperExceptionPage()中间件启用详细错误。 在标准的 ASP.NET Core 模板中，它们可以根据环境变量有条件地切换：

public class Startup {
  …
  public static void Configure(IApplicationBuilder app, IWebHostEnvironment env) {
    if (env.IsDevelopment()) {
      app.UseDeveloperExceptionPage();
    }
  }
}

在这种情况下，您只需将应用服务配置的ASPNETCORE_ENVIRONMENT配置变量更改为Development 。

注意：这样做会暴露所有异常的详细信息，并可能导致潜在的安全漏洞。 这应该只为其他安全的开发环境启用，或者作为面向公众的服务器上的临时故障排除技术。

检测到特定错误

就我而言，这暴露了以下内容：

500.31 ANCM 无法找到本机依赖项

此问题的常见解决方案：

未找到指定版本的 Microsoft.NetCore.App 或 Microsoft.AspNetCore.App。

ANCM 检测到的特定错误：

错误：未找到应用程序依赖项清单 (Project.deps.json) 中指定的程序集：包：'Microsoft.Data.SqlClient'，版本：'1.0.19269.1' 路径：'runtimes/win/lib/netcoreapp2.1 /Microsoft.Data.SqlClient.dll'

现在，您的应用程序正在寻找的确切底层依赖可能会有所不同。 但关键点是，即使它能够加载正确的 .NET 运行时（在我的例子中是 .NET Core 3.1），它仍然试图从 .NET Core 2.1 运行时加载遗留依赖项，从而触发此错误。 但是除非您首先启用UseDeveloperExceptionPage()否则您将无法确定 Azure 应用服务上的依赖项。

解决问题

实际的解决方案显然取决于您收到的确切错误。 在这种情况下，提供对最新Microsoft.Data.SqlClient NuGet 包的显式引用可解决该问题，并允许 Azure 应用服务正确显示站点。

也就是说，我仍然不清楚为什么直接从 Visual Studio 发布时这有效，但通过 Azure DevOps Pipeline 发布时失败。 我知道在使用dotnet publish各种标志时包含的依赖项可能存在细微的差异，因此我的假设是 Visual Studio 和Azure App Service Deploy任务调用dotnet publish的方式存在差异。

Answer 2

在我们的例子中，它是需要更新到 dotnet 5 的应用服务上的日志扩展。

Answer 3

感谢@tjaart。 在将代码更新为 .NET 5.0 并将 Azure 站点插槽上的运行时更改为 .NET 5.0 后，我遇到了同样的问题然后向我发送有关如何构建 NET 5.0 azure 应用程序的链接！！）我决定在安装到新的 .NET 5 服务器（工作正常）之前在搜索网络时再做一次更改，我看到了这个......我更新日志扩展从 5.0.0-preview-3-20215-14 到 6.0.0-rc-2-21480-10 和服务现在正在运行。

太感谢了....