Nginx中gzip资源压缩的5大场景配置实战指南

# ❌ 危险的“万能”配置（生产环境慎用！）
gzip on;
gzip_types *;
gzip_min_length 10;
gzip_comp_level 6;

# /etc/nginx/conf.d/frontend.conf
server {
    listen 80;
    server_name app.example.com;

    # 启用 gzip（全局开关）
    gzip on;
    gzip_vary on;                    # 关键！让缓存系统区分压缩/未压缩版本
    gzip_proxied any;                # 对代理响应也启用（重要！后端 Java 可能返回未压缩体）
    gzip_disable "msie6";            # 兼容 IE6（若仍需支持）

    # ✅ 精确 MIME 类型白名单（拒绝 *！）
    gzip_types
        text/css
        text/javascript
        text/html
        text/plain
        application/javascript
        application/json
        application/xml
        application/rss+xml
        image/svg+xml;

    # 分层最小长度（小文件不压，大文件必压）
    gzip_min_length 512;

    # 统一中等压缩等级（兼顾速度与体积）
    gzip_comp_level 6;

    # 静态资源根目录
    location /static/ {
        alias /var/www/app/static/;
        expires 1y;
        add_header Cache-Control "public, immutable";
        
        # 针对 .map 文件单独降级（可选）
        location ~ \.map$ {
            gzip_comp_level 3;
            gzip_min_length 2048;
        }
    }

    # HTML 入口页（常含动态变量，需配合后端）
    location / {
        proxy_pass http://backend_java;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        # 传递 Accept-Encoding 给后端，让 Java 层也可决策
        proxy_set_header Accept-Encoding $http_accept_encoding;
    }
}

// vite.config.ts（Vite 项目）
export default defineConfig({
  build: {
    rollupOptions: {
      output: {
        // ❌ 关闭 Vite 自动 gzip（交由 Nginx 统一处理）
        manualChunks: undefined,
      }
    },
    // ✅ 启用 brotli（更优替代，见后文扩展）
    brotliSize: false, // 不校验大小
  }
})

# application.yml
server:
  compression:
    enabled: false  # 🔑 关键！交由 Nginx 统一处理
    mime-types: ""  # 清空（即使 enabled: true 也不生效）

// CompressHintFilter.java
@Component
@Order(Ordered.HIGHEST_PRECEDENCE)
public class CompressHintFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response,
                         FilterChain chain) throws IOException, ServletException {
        HttpServletResponse httpResponse = (HttpServletResponse) response;
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        // 对 /api/** JSON 响应添加 hint（仅作标识，Nginx 需配合配置）
        String requestURI = httpRequest.getRequestURI();
        if (requestURI.startsWith("/api/") && 
            "application/json".equals(httpResponse.getContentType())) {
            // 建议 Nginx 压缩（实际由 gzip_types 控制，此头仅为可观测性）
            httpResponse.setHeader("X-Content-Compress", "auto");
        }
        chain.doFilter(request, response);
    }
}

# 在 upstream 或 location 中添加
location /api/ {
    proxy_pass http://spring_boot_backend;
    
    # 关键：强制清除上游可能误设的 Content-Encoding
    proxy_hide_header Content-Encoding;
    proxy_hide_header Vary;

    # ✅ 确保 Nginx 对 JSON 响应执行压缩（即使上游没设）
    proxy_set_header Accept-Encoding "gzip";
    
    # 可选：根据 X-Content-Compress 头做条件压缩（需 nginx-plus 或第三方模块）
    # 此处用基础版，依赖 gzip_types 白名单即可
}

# 全局 gzip_types 已包含 application/json → 自动生效

location / {
    proxy_pass http://java_template_engine;

    # 1️⃣ 强制指定响应编码（关键！）
    charset utf-8;

    # 2️⃣ 确保 gzip_types 包含 text/html
    # （已在全局配置）

    # 3️⃣ 禁用可能的编码转换（避免 gzip 与 charset 冲突）
    proxy_force_ranges off;

    # 4️⃣ 设置 Vary 头（Nginx 自动加，此处显式确认）
    add_header Vary "Accept-Encoding";
}

// ThymeleafConfig.java
@Bean
public SpringTemplateEngine templateEngine() {
    SpringTemplateEngine templateEngine = new SpringTemplateEngine();
    // ✅ 确保模板输出 UTF-8
    templateEngine.setTemplateResolver(templateResolver());
    return templateEngine;
}
@Bean
public TemplateResolver templateResolver() {
    ServletContextTemplateResolver resolver = new ServletContextTemplateResolver();
    resolver.setCharacterEncoding("UTF-8"); // 🔑
    resolver.setCacheable(false); // 开发期关缓存，压缩不影响
    return resolver;
}

Content-Encoding: gzip
Vary: Accept-Encoding
Content-Length: 12480  ← 明显小于原始 HTML（如 42KB）

# 字体路径（/fonts/）
location /fonts/ {
    alias /var/www/app/fonts/;
    expires 1y;
    add_header Cache-Control "public, immutable";

    # ✅ 显式允许 SVG 压缩（image/svg+xml 已在 gzip_types 中）
    # ❌ 禁止 WOFF2（通过 map 拦截）
    if ($sent_http_content_type = "font/woff2") {
        gzip off;
    }

    # 可选：对 WOFF 降级压缩
    if ($sent_http_content_type = "font/woff") {
        gzip_comp_level 3;
        gzip_min_length 1024;
    }
}

@font-face {
  font-family: 'MyFont';
  src: url('/fonts/myfont.woff2') format('woff2'), /* ✅ 首选 */
       url('/fonts/myfont.woff') format('woff');   /* ⚠️ 回退 */
  font-weight: normal;
  font-style: normal;
}

gzip_min_length 10; # 对 328 字节的 health 响应也压缩 → 得不偿失

# 健康检查路径（禁用压缩）
location /actuator/health {
    proxy_pass http://spring_boot_backend;
    gzip off; # 🔑 强制关闭
}

# metrics 路径（启用压缩）
location /actuator/metrics {
    proxy_pass http://spring_boot_backend;
    # 继承全局 gzip 配置（因 >1KB，自动触发）
}

# Prometheus 指标（大文本，明确启用）
location /prometheus {
    proxy_pass http://prometheus_exporter;
    # 全局 gzip_types 已含 application/json → 自动生效
}

# 启用 Brotli（需 Nginx 编译支持）
brotli on;
brotli_comp_level 6;
brotli_types
    text/css
    text/javascript
    text/html
    application/json
    application/xml
    image/svg+xml;

# 与 gzip 共存：按 Accept-Encoding 自动协商
gzip on;
gzip_types ... ; # 同前

# ✅ 关键：Vary 头需同时包含两者
add_header Vary "Accept-Encoding";

location /events/ {
    proxy_pass http://sse_backend;
    proxy_buffering off;          # 关键：禁用缓冲
    proxy_cache off;
    gzip off;                       # 🔑 绝对禁用
    chunked_transfer_encoding on;

    # 保持长连接
    proxy_http_version 1.1;
    proxy_set_header Connection '';
}

location /nginx_status {
    stub_status on;
    access_log off;
    allow 127.0.0.1;
    deny all;
}

# 定义日志格式（含压缩信息）
log_format gzip_log '$remote_addr - $remote_user [$time_local] '
                     '"$request" $status $body_bytes_sent '
                     '"$http_referer" "$http_user_agent" '
                     'gzip: $gzip_ratio req_time: $request_time';

access_log /var/log/nginx/gzip_access.log gzip_log;

# 测量原始体积与延迟
ab -n 1000 -c 100 -H "Accept-Encoding: identity" http://app.example.com/api/products
# → Body size: 245800 bytes, Time per request: 178ms

# 在 /api/products location 中临时启用
gzip on;
gzip_types application/json;
gzip_min_length 1024;
gzip_comp_level 6;

ab -n 1000 -c 100 -H "Accept-Encoding: gzip" http://app.example.com/api/products
# → Body size: 58200 bytes (-76%), Time per request: 142ms (-20%)

# 监控 Nginx worker CPU
top -p $(pgrep -f "nginx: worker")
# → 观察 %CPU 是否稳定 < 30%

# 仅对特定 UA 启用（如内部测试流量）
map $http_x_test_flag $enable_gzip {
    "true" "on";
    default "off";
}
gzip $enable_gzip;