Azure Web App虚拟应用如何使用自身web.config而非根目录配置？

问题核心 #

根应用配置会默认向下继承，若根web.config包含通配符路由、模块设置，会拦截子虚拟应用的请求，导致/feature路径加载根应用配置而非自身文件。

1. 修正虚拟应用配置与隔离根配置 #

调整Azure门户路径映射 #

• 进入Web App的配置 > 路径映射，确认/feature的设置：
  • 类型：Application（而非Virtual Directory）
  • 物理路径：使用/site/wwwroot/feature（Azure环境推荐正斜杠路径）
• 根应用的/路径保持site/wwwroot与Application类型不变。

隔离根应用配置 #

在根应用的web.config中添加inheritInChildApplications="false"，阻止配置被子应用继承：

<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <!-- 根应用原有的模块、处理程序、路由等配置 -->
    </system.webServer>
  </location>
</configuration>

2. 确保子应用web.config独立生效 #

site/wwwroot/feature下的web.config需包含完整的应用启动配置，以ASP.NET Core为例：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
    </handlers>
    <aspNetCore processPath="dotnet" arguments=".\FeatureApp.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
  </system.webServer>
</configuration>

确保子应用的依赖项、启动程序集配置完整，不依赖根应用的配置。

3. 持续部署自动创建虚拟应用 #

方式一：Azure CLI集成CI/CD #

在GitHub Actions、Azure DevOps等CI/CD流程中添加以下命令，直接覆盖虚拟应用配置：

az webapp config appsettings set --name <你的WebApp名称> --resource-group <资源组名称> --settings WEBSITE_VIRTUAL_APPS="[{'virtualPath':'/','physicalPath':'site/wwwroot'},{'virtualPath':'/feature','physicalPath':'site/wwwroot/feature','preloadEnabled':true}]"

方式二：ARM/Bicep模板部署 #

使用Bicep模板定义Web App的虚拟应用配置，集成到部署流程：

resource webApp 'Microsoft.Web/sites@2022-09-01' = {
  name: '<你的WebApp名称>'
  location: resourceGroup().location
  properties: {
    serverFarmId: '<你的App Service Plan资源ID>'
    siteConfig: {
      virtualApplications: [
        {
          virtualPath: '/'
          physicalPath: 'site/wwwroot'
          preloadEnabled: true
        }
        {
          virtualPath: '/feature'
          physicalPath: 'site/wwwroot/feature'
          preloadEnabled: true
        }
      ]
    }
  }
}

验证方法 #

1. 访问[URL]/feature，检查是否加载子应用专属内容
2. 通过Kudu工具（[URL].scm.azurewebsites.net）查看子应用日志，确认启动时加载的是自身web.config
3. 对比根应用与子应用的请求响应头，确认配置隔离生效

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