Azure虚拟目录WebDeploy后Asp.Net Core WebApi出现内部服务器错误

我之前也踩过这个部署场景的坑，这种共用URL的虚拟目录配置很容易忽略细节，给你几个实用的排查和修复方向：

1. 确认虚拟目录的核心配置 #

先去Azure门户里核对虚拟目录的关键设置：

• 进入你的Web App → 配置 → 路径映射 → 虚拟应用程序和目录
• 确保/webapi对应的物理路径是site\wwwroot\webapi（注意用反斜杠，且WebAPI的发布文件确实都传到了这个目录）
• 一定要勾选这个虚拟目录的应用程序选项——WebAPI是独立的.NET Core应用，不是静态文件目录，不勾选的话Azure会把它当成普通静态资源处理，自然会报错

2. 验证WebAPI发布文件的完整性 #

有时候发布过程中会出现文件丢失，导致应用无法启动：

• 打开Azure的高级工具（Kudu） → 点击「前往」→ 进入文件管理器，找到site\wwwroot\webapi目录
• 检查是否存在web.config、bin文件夹，以及WebAPI项目的主程序集DLL
• 如果文件不全，重新发布WebAPI，发布时确认目标路径选择正确

3. 检查WebAPI的web.config配置 #

ASP.NET Core的web.config是应用启动的关键，很容易出配置错误：

• 打开WebAPI的web.config，确认aspNetCore节点配置正确，示例如下：

  <system.webServer>
    <handlers>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
    </handlers>
    <aspNetCore processPath="dotnet" arguments=".\YourWebApiProject.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="outofprocess" />
  </system.webServer>
  

• 注意arguments里的DLL名称要和你WebAPI项目生成的完全一致；如果MVC应用用的是inprocess托管模式，建议WebAPI改成outofprocess避免进程冲突

4. 查看详细错误日志定位问题 #

500错误太笼统，必须看具体错误信息：

• 在Web App的日志 → 日志流里查看实时错误输出
• 如果开启了stdoutLogEnabled，可以在Kudu的site\wwwroot\webapi\logs目录下找到stdout日志，里面会有详细的启动异常信息
• 也可以在WebAPI的appsettings.json里把日志级别设为Debug，重新发布后获取更细致的错误追踪

5. 确认路由配置无冲突 #

虽然是两个独立应用，但路由规则可能会互相干扰：

• 确保WebAPI的路由前缀包含/webapi，比如在Program.cs里全局配置：

  app.MapControllers().WithMetadata(new RouteAttribute("webapi/[controller]"));
  

• 或者直接在控制器上添加[Route("webapi/[controller]")]特性，避免和MVC的路由规则混淆

6. 核对应用池的.NET版本 #

确认Web App的应用池.NET版本和你的两个应用目标框架一致：

• 进入Web App → 配置 → 常规设置 → .NET版本，选择对应版本（比如.NET 6.0、.NET 7.0）
• 如果是自包含部署，要选择「独立」模式

我之前就是因为漏勾选虚拟目录的「应用程序」选项，导致WebAPI无法被正确识别，改完之后就正常访问了，你可以按这个顺序排查试试。

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