WRITE ONCE. READ EVERYWHERE.

一条公告,
抵达每一次访问。

运营发布限时活动,访客从 KV 读取公告与跳转配置。用一条真实数据,走完写入、读取、更新、过期和删除。

Cloudflare KV 运行环境真实读取,不人为模拟延迟;同一网络通常会到达同一机房。
01 / WRITE PATH

发布活动配置

PUT

这是独立测试空间。首次保存创建 Key,再次保存同一标识会覆盖整份 JSON。

02 / READ PATH

访客实际读取

GET

这里每次都请求后端读取 KV,不使用编辑器中的草稿或写入回执。

打开独立访客页 ↗
FIELDNOTES创意与工具 · 活动现场
日常营业 / ALWAYS OPEN

等待第一次读取

先读取一次,再发布公告,还可以观察“不存在”结果的缓存。

HTTP 响应使用 no-store,但 KV 内部缓存仍然存在。把 cacheTtl 改小不会清除已经缓存的旧值。倒计时依据浏览器时钟;跳转接口仍会以服务端时间检查截止时间。

03 / BROWSE KEYS

配置目录

LIST + METADATA

每页 3 条,标题直接取自 metadata,无需逐条 get。目录也可能滞后;写入后可手动刷新。

活动标识标题 / metadata版本过期时间操作

本页暂无记录。先保存公告,再刷新目录;空页也可能仍有下一页。

当前筛选:全部 · 0 条
TRY IT / 4 个小实验

从“保存成功”到“读到新值”

  1. 先读,再写。先读取不存在的 homepage,再保存预填公告,观察 null 何时变为数据。
  2. 修改后比较版本。换一个标题再保存。右侧读取与独立访客页都从 KV 获取;不拿本地草稿冒充读取结果。
  3. 观察自动过期。设为 60 秒,等待截止时间后再读。公告恢复默认内容,活动跳转返回 404。
  4. 测试目录与删除。新建并保存 4 条不同活动,验证分页、前缀过滤与删除。所有测试记录最多保留 24 小时。

适用:配置、公告、跳转映射等读多写少的场景。KV 不提供原子计数、事务或“撤销立即全球生效”的保证。

测试空间由 HttpOnly Cookie 持有写权限;分享链接只包含公开空间标识。清除 Cookie 会失去原空间的编辑入口。此示例展示的公告数据均可公开读取,不要填写敏感信息。

Cloudflare KV 原理 ↗ · 返回项目首页