ASP.NET Core 6+ 默认不启用 Gzip 压缩
从 ASP.NET Core 6 开始,
ResponseCompression中间件默认未启用,即使你安装了
Microsoft.AspNetCore.ResponseCompression包也不会自动压缩响应。必须显式注册服务并启用中间件,否则所有
Accept-Encoding: gzip请求都会被忽略,返回未压缩内容。 检查是否调用了
services.AddResponseCompression()和
app.UseResponseCompression()注意调用顺序:
UseResponseCompression()必须在
UseRouting()之后、
UseEndpoints()或
UseAuthorization()之前(取决于你的管道结构) 默认只压缩
text/plain、
text/css、
application/javascript等 MIME 类型,
application/json不在默认列表中,需手动添加
如何正确注册并配置 Gzip 压缩
在
Program.cs(.NET 6+)中,需显式配置压缩提供程序和 MIME 类型白名单:
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddResponseCompression(options =>
{
options.EnableForHttps = true; // 生产环境建议开启 HTTPS 下压缩
options.Providers.Add<GzipCompressionProvider>();
});
builder.Services.Configure<GzipCompressionProviderOptions>(options =>
{
options.Level = System.IO.Compression.CompressionLevel.Optimal;
});
然后在
app构建后启用中间件:
var app = builder.Build(); app.UseResponseCompression(); // 必须放在 UseStaticFiles() 之后、UseRouting() 之后
EnableForHttps默认为
false,若部署在反向代理(如 Nginx)后且代理已处理压缩,此处可设为
false避免重复压缩 若需压缩 JSON 响应,必须扩展 MIME 类型列表:
builder.Services.AddResponseCompression(options =>
{
options.MimeTypes = ResponseCompressionDefaults.MimeTypes.Concat(new[] { "application/json" });
});
为什么静态文件没被压缩?
UseStaticFiles()默认绕过中间件管道,因此
UseResponseCompression()对它无效。解决方法有两种: 改用
UseStaticFiles(new StaticFileOptions { OnPrepareResponse = ... }) 手动设置 Vary: Accept-Encoding头,并依赖客户端或 CDN 缓存逻辑(但不压缩内容本身) 更可靠的方式:禁用
UseStaticFiles()的默认行为,改由 MVC 或终结点路由统一处理静态资源(不推荐,影响性能) 生产环境强烈建议由 Nginx / CDN 层处理静态文件压缩,而非 Kestrel
验证是否生效:用
curl -H "Accept-Encoding: gzip" -I https://yoursite/api/values查看响应头是否含
Content-Encoding: gzip和
Vary: Accept-Encoding。
Gzip vs Brotli:该选哪个?
.NET 支持
BrotliCompressionProvider,压缩率通常优于 Gzip,但兼容性略低(IE11 不支持,旧版 Android WebView 可能有问题): 同时启用两者时,框架按客户端
Accept-Encoding优先级自动选择(如
br,gzip优先 Brotli) 启用 Brotli 只需在配置中多加一行:
options.Providers.Add<brotlicompressionprovider>();</brotlicompressionprovider>Brotli 默认压缩等级为
Optimal,但内存占用略高;若服务内存紧张,可设为
FasterKestrel 对 Brotli 的流式压缩支持比 Gzip 更成熟,尤其在大响应体场景下延迟更低
真实部署中,多数团队会同时注册 Gzip 和 Brotli,靠客户端协商决定——除非明确要支持 IE11 或特定嵌入式设备,否则不必只留 Gzip。
