如何访问直接放在Azure Web App Kudu的home/site/wwwroot下的HTML页面

问题根因 #

.NET Core MVC 默认的请求处理管道没有正确配置静态文件服务，或者MVC路由优先级高于静态文件处理逻辑，导致手动上传到wwwroot的HTML文件无法被正常识别返回，最终抛出404错误。

代码侧修复方法 #

• 调整Startup.cs配置顺序，确保静态文件中间件放在路由、MVC中间件之前，3.1版本配置示例如下：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 异常处理、HSTS、HTTPS重定向等基础配置放在最前面

    // 静态文件中间件必须放在UseRouting、UseEndpoints之前
    app.UseStaticFiles();

    app.UseRouting();

    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    });
}

• 如果默认MIME映射不生效，可以手动指定HTML文件的MIME类型：

app.UseStaticFiles(new StaticFileOptions
{
    ContentTypeProvider = new FileExtensionContentTypeProvider
    {
        Mappings = { [".html"] = "text/html" }
    }
});

• 也可以直接用app.UseFileServer()替换app.UseStaticFiles()，会自动启用静态文件服务、默认文档匹配逻辑，适配静态HTML访问场景。

Azure门户侧修复方法 #

• 修改web.config配置：在Kudu的home/site/wwwroot目录下找到（没有就手动新建）web.config文件，添加静态文件映射规则：

<configuration>
  <system.webServer>
    <staticContent>
      <remove fileExtension=".html" />
      <mimeMap fileExtension=".html" mimeType="text/html" />
    </staticContent>
    <handlers>
      <add name="StaticFile" path="*" verb="*" modules="StaticFileModule,DefaultDocumentModule,DirectoryListingModule" resourceType="Either" requireAccess="Read" />
    </handlers>
  </system.webServer>
</configuration>

• 检查路径映射配置：进入Azure Web App门户页→【配置】→【路径映射】，确认根路径/对应的物理路径为site\wwwroot，和你上传HTML文件的路径一致。
• 检查身份验证规则：如果开启了Azure Web App的全局身份验证，检查是否拦截了静态HTML文件的匿名访问，可以临时关闭身份验证测试，确认是该问题后单独配置HTML路径的匿名访问权限即可。

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