C# 响应压缩方法 C# ASP.NET Core如何启用Gzip压缩_技术教程

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。