# 响应头：缓存 1 小时
Cache-Control: max-age=3600

from http.server import HTTPServer, BaseHTTPRequestHandler
import time

class CacheHandler(BaseHTTPRequestHandler):
    def do_GET(self):
        if self.path == '/api/data':
            self.send_response(200)
            self.send_header('Content-Type', 'application/json')
            self.send_header('Cache-Control', 'max-age=60')  # 缓存 60 秒
            self.end_headers()
            self.wfile.write(f'{{"time": "{time.time()}"}}'.encode())

# 过期时间点（HTTP/1.0 遗留）
Expires: Wed, 10 May 2026 11:00:00 GMT

# 首次请求
GET /api/users HTTP/1.1

# 响应
HTTP/1.1 200 OK
ETag: "v1-abc123"
Cache-Control: no-cache
Content-Length: 256
[响应体]

# 后续请求（带 ETag）
GET /api/users HTTP/1.1
If-None-Match: "v1-abc123"

# 如果未修改
HTTP/1.1 304 Not Modified
ETag: "v1-abc123"

# 如果已修改
HTTP/1.1 200 OK
ETag: "v2-def456"
[新的响应体]

# 首次请求
GET /image.jpg HTTP/1.1

# 响应
HTTP/1.1 200 OK
Last-Modified: Wed, 10 May 2026 10:00:00 GMT
Content-Length: 102400

# 后续请求
GET /image.jpg HTTP/1.1
If-Modified-Since: Wed, 10 May 2026 10:00:00 GMT

# 如果未修改
HTTP/1.1 304 Not Modified

import hashlib
import json

# 1. 内容 hash（最精确）
def generate_etag_by_content(content):
    hash_val = hashlib.md5(content.encode()).hexdigest()
    return f'"{hash_val}"'

# 2. 版本号（适合 API）
def generate_etag_by_version(version):
    return f'"v{version}"'

# 3. 修改时间 + 大小（适合静态文件）
def generate_etag_by_mtime(mtime, size):
    hash_val = hashlib.md5(f"{mtime}-{size}".encode()).hexdigest()
    return f'"{hash_val}"'

# Express.js ETag
const express = require('express');
const app = express();

// 使用自定义 ETag
app.set('etag', 'strong');  // 默认

// 或自定义 ETag 生成
app.use((req, res, next) => {
    const originalJson = res.json;
    res.json = function(data) {
        const etag = generate_etag_by_content(JSON.stringify(data));
        res.set('ETag', etag);
        return originalJson.call(this, data);
    };
    next();
});

# 强 ETag — 字节级精确匹配
ETag: "abc123"

# 弱 ETag — 语义等价即可
ETag: W/"abc123"

server {
    listen 443 ssl;
    server_name example.com;

    # 静态资源 — 长期缓存
    location ~* \.(css|js|woff2|png|jpg|gif|ico)$ {
        # 文件名带 hash 时
        add_header Cache-Control "public, max-age=31536000, immutable";
        add_header Vary "Accept-Encoding";
        
        # gzip
        gzip on;
        gzip_types text/css application/javascript;
    }

    # HTML — 协商缓存
    location / {
        add_header Cache-Control "no-cache";
        add_header Vary "Accept-Encoding";
        try_files $uri $uri/ /index.html;
    }

    # API — 不缓存或短时间缓存
    location /api/ {
        add_header Cache-Control "no-store";
        proxy_pass http://backend;
    }

    # 图片 — 中期缓存
    location /images/ {
        add_header Cache-Control "public, max-age=2592000";
    }
}

const express = require('express');
const crypto = require('crypto');
const app = express();

// ETag 中间件
function conditionalCache(req, res, next) {
    const originalJson = res.json.bind(res);
    
    res.json = function(data) {
        const body = JSON.stringify(data);
        const etag = `"${crypto.createHash('md5').update(body).digest('hex')}"`;
        
        res.set('ETag', etag);
        res.set('Last-Modified', new Date().toUTCString());
        
        // 检查 If-None-Match
        const clientEtag = req.headers['if-none-match'];
        if (clientEtag === etag) {
            return res.status(304).end();
        }
        
        return originalJson(data);
    };
    
    next();
}

app.use(conditionalCache);

// API 路由 — 短期缓存
app.get('/api/products', (req, res) => {
    res.set('Cache-Control', 'public, max-age=60');
    res.json({ products: [...] });
});

// 用户数据 — 私有缓存
app.get('/api/profile', (req, res) => {
    res.set('Cache-Control', 'private, max-age=300');
    res.json({ user: {...} });
});

// 实时数据 — 不缓存
app.get('/api/notifications', (req, res) => {
    res.set('Cache-Control', 'no-store');
    res.json({ notifications: [...] });
});

Vary: Accept, Accept-Encoding, Accept-Language

# Nginx Vary 配置
gzip_vary on;  # 自动添加 Vary: Accept-Encoding

# 根据 Accept 缓存不同格式
location /api/data {
    if ($http_accept ~* "application/json") {
        add_header Vary "Accept";
    }
}

// 版本号方式 — 清除旧版本缓存
const ASSET_VERSION = '20260510';

app.get('/', (req, res) => {
    res.send(`
        <html>
        <head>
            <link rel="stylesheet" href="/style.css?v=${ASSET_VERSION}">
            <script src="/app.js?v=${ASSET_VERSION}"></script>
        </head>
        </html>
    `);
});

// Content Hash 方式 — 自动缓存失效
// webpack 输出: app.a1b2c3d4.js
// 内容变化 → hash 变化 → 新文件名 → 缓存自动失效