.NET Core访问wwwroot下ASHX文件报404错误的解决方法

核心原因 #

你之前配置MIME类型的排查方向错误，配置无效的根本原因有两点：

• .ashx是传统ASP.NET框架下的HTTP处理程序格式，默认不属于静态文件范畴，.NET Core的静态文件中间件不会默认放行这类扩展名
• IIS的web.config中配置的staticContent MIME映射仅对IIS直接处理的静态请求生效，.NET Core默认由Kestrel托管处理请求、IIS仅做反向代理，Kestrel的静态文件中间件有独立的文件类型校验逻辑，不会读取IIS的MIME配置。

分场景解决 #

你需要先明确自己的需求，对应调整配置：

场景1：仅需要将wwwroot下的myfile.ashx作为静态文件直接访问 #

1. 先删除之前在web.config中添加的.ashx MIME映射配置，避免IIS层出现配置冲突
2. 修改项目中静态文件中间件的注册逻辑（.NET 6+ 项目在Program.cs中，.NET 5及以下在Startup.cs中），给静态文件中间件的ContentTypeProvider追加.ashx扩展名的类型映射，示例代码：

var ashxContentTypeProvider = new FileExtensionContentTypeProvider();
// 根据ashx文件的实际内容配置MIME类型，HTML内容填text/html，纯文本填text/plain
ashxContentTypeProvider.Mappings[".ashx"] = "text/html";

app.UseStaticFiles(new StaticFileOptions
{
    ContentTypeProvider = ashxContentTypeProvider
});

3. 确认app.UseStaticFiles()的注册位置在路由、授权、异常处理中间件之前，顺序错误会导致请求被其他中间件拦截。

场景2：需要让.ashx像传统ASP.NET一样执行后端处理逻辑 #

• 首先不要把.ashx文件放在wwwroot目录下，wwwroot是静态资源专属目录，存放在这里的文件默认不会进入后端业务处理管道
• 两种实现方式：要么将原本ashx里的处理逻辑迁移为ASP.NET Core的最小API、控制器接口或者自定义中间件；要么安装ASP.NET Core的System.Web兼容包适配传统ASHX处理逻辑，直接放在wwwroot下永远无法触发执行。

额外排查项 #

如果上述配置完成后仍然返回404，按顺序校验以下配置：

• 确认发布部署后的站点wwwroot目录下确实存在myfile.ashx文件，如果是Linux/Unix部署环境，文件名大小写需要和访问地址完全匹配
• 右键点击项目中的myfile.ashx文件，将属性中「复制到输出目录」设置为「如果较新则复制」，避免发布时文件被遗漏
• 如果是IIS部署，检查IIS的「请求筛选」模块中是否存在.ashx扩展名的拒绝访问规则，存在则删除对应规则
• 如果开启了CDN或者反向代理缓存，先清理缓存再重试访问。

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