HTTP Cache-Control stale-while-revalidate 与 immutable 资源治理实践

核心价值`stale-while-revalidate` 允许在过期后短期使用陈旧副本并后台更新，提升响应速度。`immutable` 适用于带指纹的静态资源，确保长时间缓存并避免不必要的再验证。API 响应治理export const runtime = 'edge'

export async function GET() {

const body = JSON.stringify({ list: [1, 2, 3], ts: Date.now() })

return new Response(body, {

headers: {

'Content-Type': 'application/json; charset=utf-8',

'Cache-Control': 'public, max-age=60, stale-while-revalidate=300',

},

})

}

指纹静态资源治理export const runtime = 'edge'

export async function GET() {

const buf = await fetch('https://cdn.example.com/app.abc123.css').then(r => r.arrayBuffer())

return new Response(buf, {

headers: {

'Content-Type': 'text/css; charset=utf-8',

'Cache-Control': 'public, max-age=31536000, immutable',

},

})

}

治理建议`stale-while-revalidate` 时段不宜过长，避免陈旧数据影响一致性；结合条件请求（ETag/Last-Modified）提升新鲜度协商效率。只有指纹化资源（内容变更会更换文件名）适合使用 `immutable`，避免对非指纹资源误用导致用户拿到过期内容。结论在 Next.js 15 的 Edge Route Handlers 中通过精细化的 Cache-Control 策略，可在保证数据一致性的同时显著提升性能与带宽利用率。