下面给你一篇 精炼、系统、适合发布到博客 / CSDN / 掘金 / 微信公众号的文章：

🚀 ASP.NET Core 响应压缩中间件的使用技巧分享（最新整理）

在现代 Web 开发中，API 的响应大小会直接影响页面加载速度和整体用户体验。ASP.NET Core 提供的 Response Compression Middleware（响应压缩中间件） 可以显著减少响应体体积，一般可压缩 60%–90%，特别适用于：

  • JSON 数据量大
  • 移动端网络差
  • SPA 前后端分离接口
  • 返回静态文本（HTML/CSS/JS）

本文总结了 ASP.NET Core 响应压缩的 启用方法、优化技巧、常见坑及最佳实践。

1️⃣ 启用响应压缩（基础版）

在 Program.cs：

builder.Services.AddResponseCompression(options =>
{
    options.EnableForHttps = true; // HTTPS 也启用压缩
});

var app = builder.Build();

app.UseResponseCompression();
app.MapControllers();
app.Run();

开启后，默认启用 gzip，并对部分 MIME 自动压缩。

2️⃣ 同时启用 Brotli + Gzip（最佳方案）

Brotli 在网页上压缩率更高，gzip 兼容性更好。

builder.Services.AddResponseCompression(options =>
{
    options.EnableForHttps = true;
    options.Providers.Add<BrotliCompressionProvider>();
    options.Providers.Add<GzipCompressionProvider>();
});

配置压缩等级：

builder.Services.Configure<BrotliCompressionProviderOptions>(o =>
{
    o.Level = CompressionLevel.Optimal;
});

builder.Services.Configure<GzipCompressionProviderOptions>(o =>
{
    o.Level = CompressionLevel.Fastest;
});

推荐组合：Brotli Optimal + Gzip Fastest

3️⃣ 最重要：设置正确的 MIME 类型

默认只压少数 MIME，因此很多 JSON 根本没被压缩。

✔ 建议自定义：

builder.Services.AddResponseCompression(options =>
{
    options.MimeTypes = ResponseCompressionDefaults.MimeTypes.Concat(new[]
    {
        "application/json",
        "application/javascript",
        "text/plain",
        "text/css",
        "text/html"
    });
});

否则你会遇到“明明开启了压缩，响应没有变化”的问题。

4️⃣ 避免压缩二进制类型（否则浪费 CPU）

图片、视频、zip 等本身已压缩，重复压缩无意义：

⛔ 不压缩的类型：

image/*
video/*
application/zip
application/pdf
application/octet-stream

务必避免把整个静态目录（wwwroot）加进去。

5️⃣ 测试响应压缩是否生效

浏览器 → F12 → Network → 某个接口 → Response Headers
出现以下之一即代表成功：

content-encoding: br
content-encoding: gzip

并查看 Size 列，压缩效果十分显著。

6️⃣ 大 JSON 的额外优化技巧

大 JSON 返回时：

  • 删除 null 字段
  • 使用 System.Text.Json（比 Newtonsoft 快）
  • 返回前做分页

示例：

builder.Services.AddControllers().AddJsonOptions(opt =>
{
    opt.JsonSerializerOptions.DefaultIgnoreCondition =
        JsonIgnoreCondition.WhenWritingNull;
});

减少数据量 → 进一步增强压缩效果。

7️⃣ 大文件下载：选择流式压缩

如果返回大文件（如 100MB 文档），可使用流式 GZip：

app.MapGet("/download", async context =>
{
    context.Response.Headers.Add("Content-Encoding", "gzip");

    using var gzip = new GZipStream(context.Response.Body, CompressionLevel.Optimal);
    await using var fs = File.OpenRead("bigfile.json");
    await fs.CopyToAsync(gzip);
});

避免一次性加载至内存（防止 OOM）。

8️⃣ Kestrel / Docker 环境 CPU 调度优化

压缩本质是 CPU 密集型操作，特别在容器中：

✔ 吞吐优先 → CompressionLevel.Fastest
✔ 带宽优先 → CompressionLevel.Optimal
✔ 建议由 Nginx 代理统一压缩（减少应用 CPU）

Nginx 示例：

gzip on;
gzip_types application/json text/css text/html text/plain;

9️⃣ 常见坑与解决方案

问题可能原因解决方法
明明启用但无压缩MIME 不匹配手动配置 MimeTypes
HTTPS 不压缩EnableForHttps=false打开该选项
图片文件压缩无效图片本身已压缩不要压缩二进制
Docker CPU 占用过高Brotli/Optimal 压缩过重调至 Fastest 或交给 Nginx

🔟 最佳实践总结（简版）

✔ 启用 Brotli + Gzip
✔ 自定义 MIME（必须）
✔ 避免二进制压缩
✔ 大 JSON 做精简
✔ 大文件用流式压缩
✔ 容器环境降低压缩等级

几行代码即可提升网站加载速度 30%–70%。