ASP.NET Core如何配置带wwwroot前缀URL正常访问静态图片

静态文件存放在wwwroot/Uploads路径下时，ASP.NET Core默认静态文件中间件会将wwwroot作为静态资源的物理根目录，不会将其识别为URL路径段，因此会出现：

• 访问https://localhost:44362/Uploads/img23.png（无wwwroot路径段）：图片正常加载
• 访问https://localhost:44362/wwwroot/Uploads/img23.png（带wwwroot路径段）：图片404无法加载

以下两种方案都可以实现保留URL中wwwroot前缀正常访问图片的需求，不会改变用户浏览器地址栏显示的路径，按需选择即可：

方案1：新增专属静态文件中间件映射（推荐） #

在Program.cs（.NET 6+ 极简模板）或Startup.cs的Configure方法中，在原有静态文件配置基础上，新增一个针对/wwwroot路径的静态文件映射配置：

// 保留原有默认静态文件配置，支持不带wwwroot的路径访问
app.UseStaticFiles();

// 新增/wwwroot路径的静态文件映射
app.UseStaticFiles(new StaticFileOptions
{
    // 匹配URL中以/wwwroot开头的请求
    RequestPath = "/wwwroot",
    // 映射到项目根目录下的wwwroot物理文件夹
    FileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, "wwwroot"))
});

注意：如果不需要保留不带wwwroot的访问能力，直接删除原有默认的app.UseStaticFiles();配置即可。

方案2：添加服务端URL重写规则 #

在静态文件中间件执行前添加重写规则，服务端内部将带/wwwroot前缀的路径转换为静态文件中间件可识别的根路径，用户侧无感知，地址栏保留wwwroot前缀：

1. 首先确保项目已安装URL重写相关包：Microsoft.AspNetCore.Rewrite
2. 在app.UseStaticFiles();代码之前添加重写配置：

using Microsoft.AspNetCore.Rewrite;

// 配置重写规则
var rewriteOptions = new RewriteOptions()
    .AddRewrite(@"^wwwroot/(.*)", "$1", skipRemainingRules: true);
app.UseRewriter(rewriteOptions);

// 原有静态文件配置保持不变
app.UseStaticFiles();

• 所有静态文件相关的中间件必须放在路由、授权、端点映射等中间件之前，否则会被拦截导致404
• 如果配置了静态文件授权、响应缓存等规则，新增的静态文件中间件需要同步对应配置，避免权限、缓存策略不一致
• 配置完成后重启应用，即可通过带wwwroot前缀的URL正常访问对应图片

内容的提问来源于stack exchange，提问作者Muhammad Sohail Khan