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.CreateBuilder(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。
