# ? 危險的“萬能”配置（生產(chǎn)環(huán)境慎用?。?
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（全局開關(guān)）
    gzip on;
    gzip_vary on;                    # 關(guān)鍵！讓緩存系統(tǒng)區(qū)分壓縮/未壓縮版本
    gzip_proxied any;                # 對代理響應(yīng)也啟用（重要！后端 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;

    # 統(tǒng)一中等壓縮等級（兼顧速度與體積）
    gzip_comp_level 6;

    # 靜態(tài)資源根目錄
    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 入口頁（常含動態(tài)變量，需配合后端）
    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: {
        // ? 關(guān)閉 Vite 自動 gzip（交由 Nginx 統(tǒng)一處理）
        manualChunks: undefined,
      }
    },
    // ? 啟用 brotli（更優(yōu)替代，見后文擴展）
    brotliSize: false, // 不校驗大小
  }
})

# application.yml
server:
  compression:
    enabled: false  # ?? 關(guān)鍵！交由 Nginx 統(tǒng)一處理
    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 響應(yīng)添加 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;
    
    # 關(guān)鍵：強制清除上游可能誤設(shè)的 Content-Encoding
    proxy_hide_header Content-Encoding;
    proxy_hide_header Vary;

    # ? 確保 Nginx 對 JSON 響應(yīng)執(zhí)行壓縮（即使上游沒設(shè)）
    proxy_set_header Accept-Encoding "gzip";
    
    # 可選：根據(jù) X-Content-Compress 頭做條件壓縮（需 nginx-plus 或第三方模塊）
    # 此處用基礎(chǔ)版，依賴 gzip_types 白名單即可
}

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

location / {
    proxy_pass http://java_template_engine;

    # 1?? 強制指定響應(yīng)編碼（關(guān)鍵！）
    charset utf-8;

    # 2?? 確保 gzip_types 包含 text/html
    # （已在全局配置）

    # 3?? 禁用可能的編碼轉(zhuǎn)換（避免 gzip 與 charset 沖突）
    proxy_force_ranges off;

    # 4?? 設(shè)置 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); // 開發(fā)期關(guān)緩存，壓縮不影響
    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 字節(jié)的 health 響應(yīng)也壓縮 → 得不償失

# 健康檢查路徑（禁用壓縮）
location /actuator/health {
    proxy_pass http://spring_boot_backend;
    gzip off; # ?? 強制關(guān)閉
}

# metrics 路徑（啟用壓縮）
location /actuator/metrics {
    proxy_pass http://spring_boot_backend;
    # 繼承全局 gzip 配置（因 >1KB，自動觸發(fā)）
}

# 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 自動協(xié)商
gzip on;
gzip_types ... ; # 同前

# ? 關(guān)鍵：Vary 頭需同時包含兩者
add_header Vary "Accept-Encoding";

location /events/ {
    proxy_pass http://sse_backend;
    proxy_buffering off;          # 關(guān)鍵：禁用緩沖
    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%)

# 監(jiān)控 Nginx worker CPU
top -p $(pgrep -f "nginx: worker")
# → 觀察 %CPU 是否穩(wěn)定 < 30%

# 僅對特定 UA 啟用（如內(nèi)部測試流量）
map $http_x_test_flag $enable_gzip {
    "true" "on";
    default "off";
}
gzip $enable_gzip;