HTTP 缓存与 304

Cache-Control:    public, max-age=0, s-maxage=<N>, stale-while-revalidate=<M>, stale-if-error=<M>
CDN-Cache-Control: max-age=<N>, stale-while-revalidate=<M>, stale-if-error=<M>
ETag:             W/"..."
Last-Modified:    <RFC 1123 date>   # 仅当该端点有稳定更新时间
Vary:             Accept-Encoding

H=$(curl -sI "https://anibt.net/rss/anime.xml?bgmId=543360&groupSlug=kirara-fantasia")
ETAG=$(echo "$H" | grep -i '^etag:' | cut -d' ' -f2- | tr -d '\r')

curl -sI -H "If-None-Match: $ETAG" \
  "https://anibt.net/rss/anime.xml?bgmId=543360&groupSlug=kirara-fantasia" | head -1
# → HTTP/2 304

T=0s    U 第一次请求
        CDN 没缓存 → 回源 O，O 拿到数据库快照 → 返回 200 + ETag=A + body
        CDN 把响应缓存 600 秒（fresh 期），再延伸 86400 秒（stale 期）
        U 拿到 200 + body + ETag=A
        U 本地记录 ETag，但因 max-age=0，下次会重新验证

T=60s   U 又来（轮询太勤）
        U 带上 If-None-Match: A 发请求
        CDN 仍在 s-maxage=600 fresh 期，可直接用边缘缓存响应 304
        (origin 0 命中)

T=700s  U 来
        U 带上 If-None-Match: A 发请求
        CDN s-maxage=600 已过期，但还在 swr=86400 内
        CDN 决策：立即把缓存里的旧版本（含 ETag=A）返回给 U；
                 同时异步发 1 个请求到 O 刷新
        U 收到响应：服务器看 If-None-Match: A == 当前 ETag → 304 Not Modified
        (用户感知：0 延迟拿到 304，知道数据没变 → 不用解析 XML)

        与此同时 CDN 异步回源：
          - 数据真没变 → O 直接返回 304 → CDN 把 fresh 期再续 600s
          - 数据有更新 → O 返回 200 + ETag=B + 新 body → CDN 替换缓存

T=900s  U 来（下一次）
        U 带 If-None-Match: A
        CDN 已有新缓存（ETag=B 或仍是 A）
        CDN 把 ETag=B 的 body 返回 → 但 U 的 If-None-Match 不匹配 → 200 + 新 body
        U 拿到新数据

# Step 1: 第一次请求，拿 ETag + 看缓存头
curl -sSI 'https://anibt.net/api/seasons/anime?season=2026-SUMMER' \
  | grep -iE '^(HTTP|etag|cache-control|cf-cache-status)'
# HTTP/2 200
# cache-control: public, max-age=0, s-maxage=600, stale-while-revalidate=86400, stale-if-error=86400
# etag: W/"sa-web-2026-SUMMER-85-1782776047080-rzdksj"
# cf-cache-status: MISS               ← 第一次穿透到 origin

# Step 2: 立刻再来一次（仍在 max-age 内，但用 -H 强制触发条件请求）
ETAG='W/"sa-web-2026-SUMMER-85-1782776047080-rzdksj"'
curl -sSI -H "If-None-Match: $ETAG" \
  'https://anibt.net/api/seasons/anime?season=2026-SUMMER' \
  | grep -iE '^(HTTP|cf-cache-status)'
# HTTP/2 304                          ← 数据没变
# cf-cache-status: HIT                ← CDN 内存里直接命中

# Step 3: 等 11 分钟后再来（s-maxage 已过期，进入 SWR 期）
sleep 660
curl -sSI -H "If-None-Match: $ETAG" \
  'https://anibt.net/api/seasons/anime?season=2026-SUMMER' \
  | grep -iE '^(HTTP|cf-cache-status|age)'
# HTTP/2 304
# cf-cache-status: STALE              ← CDN 给旧版本，后台已异步刷新
# age: 367                            ← 这份缓存已存在 367 秒

import requests, time

URL = 'https://anibt.net/rss/anime.xml?bgmId=543360&groupSlug=kirara-fantasia,haruhana&language=CHS'
state = {'etag': None, 'last_modified': None}

def poll():
    headers = {}
    if state['etag']:          headers['If-None-Match']     = state['etag']
    if state['last_modified']: headers['If-Modified-Since'] = state['last_modified']

    r = requests.get(URL, headers=headers, timeout=10)
    if r.status_code == 304:
        print(f"[{time.strftime('%H:%M:%S')}] 304 not modified, body 0 bytes")
        return None  # 数据没变，不用解析
    if r.status_code == 200:
        state['etag']          = r.headers.get('ETag')
        state['last_modified'] = r.headers.get('Last-Modified')
        print(f"[{time.strftime('%H:%M:%S')}] 200 OK, body {len(r.content)} bytes, "
              f"cf-cache-status={r.headers.get('cf-cache-status')}")
        return r.content
    if r.status_code == 429:
        retry = int(r.headers.get('Retry-After', '60'))
        print(f"rate-limited, sleeping {retry}s")
        time.sleep(retry); return poll()
    r.raise_for_status()

# 每 15 分钟轮询一次
while True:
    poll()
    time.sleep(15 * 60)