ASP.NET Core中的响应压缩是框架提供的一项性能优化功能，它会在服务端将HTTP响应内容按照指定算法进行压缩后再返回给客户端，客户端接收到压缩内容后再解压处理，整个过程对业务代码透明。该功能主要适用于返回文本类内容的场景，比如JSON数据、HTML页面、CSS、JavaScript文件等，对于已经压缩过的二进制文件如图片、视频等，开启响应压缩反而可能增加服务端开销，没有实际优化效果。
响应压缩的核心特性
ASP.NET Core的响应压缩功能通过中间件实现，内置了多种压缩算法支持，同时提供了灵活的配置选项，主要特性如下：
- 默认支持Brotli和Gzip两种压缩算法，Brotli的压缩效率通常优于Gzip
- 会根据请求头中的
Accept-Encoding字段自动选择客户端支持的压缩算法 - 可以通过配置指定需要压缩的响应内容类型，也可以排除特定类型的响应
- 支持自定义压缩提供程序，满足特殊的压缩需求
基础启用步骤
在ASP.NET Core项目中启用响应压缩只需要三步，操作非常简单：
第一步：添加响应压缩服务
在Program.cs的WebApplicationBuilder阶段，调用AddResponseCompression方法注册响应压缩相关服务，示例代码如下：
var builder = WebApplication.CreateBuilder(args);
// 添加响应压缩服务
builder.Services.AddResponseCompression(options =>
{
// 启用压缩，默认就是true，这里显式声明方便理解
options.EnableForHttps = true;
});
var app = builder.Build();
第二步：注册响应压缩中间件
需要在请求管道中尽早注册响应压缩中间件，一般放在异常处理中间件之后，静态文件中间件之前，确保大部分响应都能被压缩处理，代码如下：
// 异常处理中间件
if (app.Environment.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
else
{
app.UseExceptionHandler("/Error");
app.UseHsts();
}
// 注册响应压缩中间件，位置要放在静态文件中间件之前
app.UseResponseCompression();
// 静态文件中间件
app.UseStaticFiles();
app.MapGet("/", () => "Hello World!");
app.Run();
第三步：验证压缩效果
启动项目后，使用浏览器开发者工具查看网络请求，检查响应头中是否包含Content-Encoding字段，值为br或gzip就说明压缩已经生效。同时可以对比响应内容的原始大小和压缩后的大小，通常文本类内容的压缩率可以达到60%以上。
自定义压缩配置
默认的响应压缩配置可能不满足所有场景，我们可以通过配置调整压缩行为：
指定压缩内容类型
默认情况下，响应压缩中间件只会压缩部分常见的文本类型，如果需要压缩自定义的内容类型，可以在配置中添加：
builder.Services.AddResponseCompression(options =>
{
options.EnableForHttps = true;
// 添加需要压缩的自定义内容类型
options.MimeTypes = ResponseCompressionDefaults.MimeTypes.Concat(
new[] { "application/json", "application/xml" }
);
});
选择压缩算法优先级
如果希望优先使用Gzip算法而不是默认的Brotli，可以自定义压缩提供程序的顺序：
builder.Services.AddResponseCompression(options =>
{
options.EnableForHttps = true;
// 指定压缩提供程序，先Gzip后Brotli
options.Providers.Add<GzipCompressionProvider>();
options.Providers.Add<BrotliCompressionProvider>();
});
// 可以单独配置Gzip的压缩级别
builder.Services.Configure<GzipCompressionProviderOptions>(options =>
{
options.Level = System.IO.Compression.CompressionLevel.Optimal;
});
使用注意事项
- 不要对已经压缩的内容再次压缩，比如图片、压缩包等，这类内容开启压缩只会浪费服务端CPU资源
- 响应压缩会增加服务端的CPU开销，对于CPU密集型的应用需要权衡压缩收益和CPU成本
EnableForHttps默认是false，因为HTTPS本身已经有加密开销，压缩后可能存在安全风险，实际生产环境如果确定安全可以开启- 响应压缩中间件需要在认证中间件之前注册吗？不需要，认证只处理请求，不影响响应压缩，放在认证之后也可以正常工作
ASP.NET_Core响应压缩中间件性能优化HTTP修改时间：2026-06-12 12:33:30