ASP.NET Core应用Docker部署时web.config的StaticFileModule失效问题

核心原因 #

Docker中运行的ASP.NET应用默认使用Kestrel服务器，你编写的web.config是IIS专属配置文件，Kestrel并不会读取或解析它——这就是该配置在IIS中生效、但Docker里完全无效的根本原因。

可行解决方案 #

方案1：沿用临时调整卷映射路径的方式

将卷映射到/app/wwwroot/.well-known即可正常访问。因为ASP.NET默认把wwwroot作为静态文件根目录，Kestrel会自动处理该目录下的静态文件请求，无需额外配置。

方案2：在代码中配置静态文件服务（无需修改卷映射）

如果不想调整卷映射路径，可以在应用的Program.cs里显式配置Kestrel处理.well-known目录的静态文件，同时替代web.config里的MIME类型设置：

var builder = WebApplication.CreateBuilder(args);

// 其他服务配置代码...

var app = builder.Build();

// 配置.well-known目录的静态文件服务
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, ".well-known")),
    RequestPath = "/.well-known",
    // 支持无扩展名文件，对应web.config中的mimeMap配置
    ServeUnknownFileTypes = true,
    DefaultContentType = "text/plain"
});

// 其他中间件配置代码...

app.Run();

方案3：排查卷挂载权限（额外验证点）

如果以上方案仍不生效，需要确认Docker卷挂载的目录权限是否正确，确保容器内的应用进程拥有读取.well-known目录及文件的权限。

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