SuperAPI AI 工具集

netlify-caching

通用与其它

查看项目

更新于 10-16 01:35

技能介绍

用途:在 Netlify CDN 上缓存来自 Functions、Edge Functions 和代理的动态与静态响应。动态响应默认不缓存,需通过响应头显式开启。

主要能力:设置 Netlify-CDN-Cache-Control(仅 Netlify CDN)、CDN-Cache-Control、Cache-Control 等头;支持 public、private、no-store、s-maxage、max-age、stale-while-revalidate、durable 等指令。用 Netlify-Vary 按 query、header、language、country、cookie 细分缓存键。用 Netlify-Cache-Tag 打标签并按标签清除,Netlify-Cache-ID 可退出原子部署自动失效。提供 purgeCache 按站点或标签清除,也可直接调用 POST https://api.netlify.com/api/v1/purge。Cache API(caches 全局)支持在函数内读写 HTTP 响应;@netlify/cache 模块提供 cacheHeaders、fetchWithCache、getCacheStatus、needsRevalidation 等辅助函数,安装命令为 npm install @netlify/cache。durable 缓存仅限 serverless,可减少边缘节点回源调用。

使用方式:在响应头中设置缓存指令,或在函数内使用 Cache API 与辅助函数;清除时在已部署函数中调用 purgeCache,CI 或本地需传入 token 与 siteID。

限制:仅 GET 被缓存,POST/PUT 等永不缓存;netlify dev 不模拟 CDN 缓存,需在部署 URL 上通过 Cache-Status 验证;静态资源最长新鲜一年,较短 max-age 被忽略;任意页面启用 basic-auth 会禁用整站缓存;durable 对 Edge Function 无效;Cache API 不能缓存 206、Vary: * 或非 GET,且 keys() 未实现;每次调用有 100 次查找、20 次写入/删除限制;清除限速为每 5 秒每标签或站点两次,超出返回 429。部分细节(如具体价格)暂未提供。