在.NET Core应用开发中，静态文件如CSS、JS、图片等资源是前端页面正常运行的基础，框架提供了内置的静态文件处理机制，开发者只需简单配置即可让应用支持静态文件访问。
默认静态文件处理配置
.NET Core默认会将wwwroot目录作为静态文件的根目录，要启用静态文件访问，需要在请求管道中添加静态文件中间件。首先在Program.cs文件中添加对应配置：
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
// 添加静态文件中间件，启用默认静态文件访问
app.UseStaticFiles();
app.MapGet("/", () => "Hello World!");
app.Run();
添加上述配置后，放在wwwroot目录下的所有文件都可以通过对应的URL直接访问，比如wwwroot/css/site.css文件可以通过/css/site.css路径访问。
自定义静态文件目录
如果静态文件没有放在默认的wwwroot目录下，或者需要额外提供其他目录的静态文件访问，可以通过StaticFileOptions自定义配置：
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
// 自定义静态文件目录，将MyStaticFiles目录作为静态文件根目录
var staticFilePath = Path.Combine(builder.Environment.ContentRootPath, "MyStaticFiles");
var options = new StaticFileOptions
{
FileProvider = new PhysicalFileProvider(staticFilePath),
RequestPath = "/static" // 访问路径前缀
};
app.UseStaticFiles(options);
app.MapGet("/", () => "Hello World!");
app.Run();
上述配置中，MyStaticFiles目录下的test.txt文件可以通过/static/test.txt路径访问，而无需暴露实际文件存储路径。
静态文件访问权限控制
默认情况下静态文件中间件会直接返回所有请求的文件，如果需要控制静态文件的访问权限，比如只有登录用户才能访问某些静态资源，可以结合授权中间件使用：
var builder = WebApplication.CreateBuilder(args);
// 添加授权服务
builder.Services.AddAuthorization();
var app = builder.Build();
// 先添加授权中间件
app.UseAuthorization();
// 对静态文件中间件添加授权要求
app.UseStaticFiles(new StaticFileOptions
{
OnPrepareResponse = ctx =>
{
// 检查用户是否登录，未登录则返回401
if (!ctx.Context.User.Identity.IsAuthenticated)
{
ctx.Context.Response.StatusCode = 401;
}
}
});
app.MapGet("/", () => "Hello World!");
app.Run();
特殊静态文件类型处理
.NET Core默认只识别常见的静态文件MIME类型，如果遇到未知扩展名的静态文件，会返回404错误。可以通过配置ContentTypeProvider添加自定义MIME类型：
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var provider = new FileExtensionContentTypeProvider();
// 添加自定义扩展名对应的MIME类型
provider.Mappings[".myres"] = "application/x-my-resource";
app.UseStaticFiles(new StaticFileOptions
{
ContentTypeProvider = provider
});
app.MapGet("/", () => "Hello World!");
app.Run();
配置完成后，扩展名为.myres的静态文件就可以正常被访问，并且会返回正确的Content-Type响应头。
注意事项
- 静态文件中间件需要放在路由中间件之前，否则静态文件请求可能无法被正确拦截处理
- 不要将敏感文件放在静态文件目录下，避免被未授权访问
- 生产环境中建议对静态文件开启缓存，减少服务器请求压力
.NET_Core静态文件处理UseStaticFiles文件访问配置中间件修改时间：2026-07-13 15:36:24