发布.NET Core 6.0.100-preview.4 API到Azure App Service报500.32错误如何解决

1. 修正项目发布配置 #

.NET 6 预览版的API项目自包含发布时，VS2019默认不会主动捆绑ASP.NET Core共享框架，会导致运行时缺失核心dll：

• 右键项目进入「发布」设置页，部署模式选择独立（Self-contained），目标运行时严格匹配Azure App Service实例架构：Windows实例选win-x86/win-x64，Linux实例选linux-x64，禁止选择「可移植」选项
• 勾选「发布前删除所有现有文件」，避免历史残留文件冲突
• 打开项目.csproj文件，在根PropertyGroup节点添加以下配置：

<PropertyGroup>
  <TargetFramework>net6.0</TargetFramework>
  <AspNetCoreHostingModel>InProcess</AspNetCoreHostingModel>
  <SelfContained>true</SelfContained>
  <!-- 替换为你实际使用的目标运行时 -->
  <RuntimeIdentifier>win-x64</RuntimeIdentifier>
  <!-- 强制捆绑ASP.NET Core运行时组件 -->
  <IncludeAspNetCoreRuntimeForSelfContained>true</IncludeAspNetCoreRuntimeForSelfContained>
</PropertyGroup>

2. 修正运行时托管配置 #

发布生成的web.config默认配置可能存在托管模式适配问题，调整如下：

<aspNetCore 
  processPath=".\你的项目启动文件名.exe" 
  stdoutLogEnabled="true" 
  stdoutLogFile=".\logs\stdout" 
  hostingModel="inprocess">
  <environmentVariables>
    <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
    <environmentVariable name="DOTNET_ROLL_FORWARD" value="Disable" />
  </environmentVariables>
</aspNetCore>

开启日志后可通过Azure Kudu控制台进入/site/wwwroot/logs路径查看具体报错信息，定位缺失的依赖组件。

3. 校验Swagger启用规则 #

默认模板生成的API项目仅在开发环境启用Swagger，确认代码中没有加环境判断限制：

// 移除if (app.Environment.IsDevelopment()) 条件判断
app.UseSwagger();
app.UseSwaggerUI();

4. 调整Azure App Service配置 #

进入Azure门户对应应用服务的「配置」-「常规设置」页：

• 运行时堆栈选择未托管代码，自包含部署不需要Azure预装.NET运行时
• Windows实例需确认「32位应用程序」开关与你发布的目标运行时匹配：发布win-x86开启，发布win-x64关闭

完成以上配置后重新发布项目即可恢复正常访问。

内容的提问来源于stack exchange，提问作者Ryan Richard