17370845950

ASP.NET Core 6+ 默认不启用 Gzip 压缩，需显式调用 AddResponseCompression() 和 UseResponseCompression()，并注意中间件顺序；默认不压缩 application/json，需手动添加 MIME 类型；静态文件因绕过管道而不被压缩，建议由 Nginx/CDN 处理；推荐同时启用 Gzip 与 Brotli，由客户端协商选择。

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.Create
Builder(args);
builder.Services.AddResponseCompression(options =>
{
    options.EnableForHttps = true; // 生产环境建议开启 HTTPS 下压缩
    options.Providers.Add();
});
builder.Services.Configure(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();
• Brotli 默认压缩等级为 Optimal，但内存占用略高；若服务内存紧张，可设为 Faster
• Kestrel 对 Brotli 的流式压缩支持比 Gzip 更成熟，尤其在大响应体场景下延迟更低

真实部署中，多数团队会同时注册 Gzip 和 Brotli，靠客户端协商决定——除非明确要支持 IE11 或特定嵌入式设备，否则不必只留 Gzip。