无需后端的数据存储方案:log-lottery如何用Dexie+IndexedDB实现浏览器本地持久化

原创2026-09-23 18:32:142,192 阅读
文章标签:前端桌面应用

无需后端的数据存储方案:log-lottery如何用Dexie+IndexedDB实现浏览器本地持久化

log-lottery 是一款 threejs + vue3 的 3D 球体动态抽奖程序,面向年会抽奖场景。它最值得一提的设计是:整个抽奖过程没有使用任何后端存储,而是依靠 Dexie 封装的浏览器 IndexedDB 实现本地持久化——主持人导入人员名单、开出中奖结果后,即使用户刷新页面甚至关闭浏览器,数据都原封不动。

💡 核心思路:用 Pinia 内存状态做“快数据”,用 IndexedDB 做“盘数据”,写入时双写,启动时读库恢复。

为什么抽奖程序可以不依赖后端

年会抽奖的参与人数通常在几十到几千人,数据量小,但纯前端程序有个痛点:刷新页面数据就丢。对抽奖来说,这意味着名单要重新导入、已中奖人员要重新核对,非常影响现场体验。

选择 IndexedDB 做浏览器本地持久化,恰好解决这个问题:

  • 零服务器:部署成本为零,人员名单这类隐私数据不离开浏览器
  • 容量大:相比 localStorage 约 5MB 的上限,IndexedDB 通常可达数百 MB 以上,存下名单和上传图片绰绰有余
  • 结构化查询:支持索引、排序、分页,而不是一个巨大的 JSON 字符串

项目里由两个库分工(依赖版本见 package.json):

  • Dexie(v4):IndexedDB 的 Promise 封装,负责名单、中奖记录、消息列表等结构化数据
  • Localforage(v1.x):负责图片、音频等二进制大文件

第一步:用 IndexDb 封装统一的数据访问层

项目没有在各处直接调用 Dexie 原生 API,而是在 src/utils/dexie/index.ts 封装了一个轻量的 IndexDb 类:

  • 构造时只需传入数据库名、表名、版本号、额外索引字段,即可自动建表
  • setData 自动为数据补上 id(uuid)、dateTime(毫秒时间戳)、type,业务代码不用操心
  • 提供 setAllData、updateData、deleteAll、getDataSortedByDateTime、getPageData 等完整的增删改查与分页方法

表结构是这套封装的关键。每张表统一索引以下字段(见 src/utils/dexie/index.ts#L22):

id, dateTime, type, uid, <自定义字段>

这样按时间排序(src/utils/dexie/index.ts#L81-L84)永远走索引字段,即使名单上千人也能快速响应。具体数据结构定义在 src/utils/dexie/type.ts,业务方可以按需扩展字段。

第二步:Pinia 状态双写,刷新页面不丢名单

最完整的示例是人员管理模块 src/store/personConfig.ts:

  1. store 创建即读库:Pinia store 初始化时先从本地数据库按 createTime 排序读出全部名单,回填到内存状态
  2. 每次操作双写:添加人员、标记中奖、删除、重置等每个 action,都先更新内存 ref,再调用 personDb 的对应方法同步落库

log-lottery 3D 抽奖程序的人员管理页面,名单数据通过 IndexedDB 在浏览器本地持久化

这套“内存 + 本地库”双写模式是抽奖体验流畅的关键——屏幕上的 3D 球体滚动读取的是毫秒级响应的内存数据,而 IndexedDB 在背后默默保证“断电不丢”。抽奖结束时,中奖人的奖品名、中奖时间会被写回名单(见 src/store/personConfig.ts#L79-L100 的回写逻辑),下次打开页面结果依然可查。

log-lottery 3D 抽奖结果页,中奖人员名单同步持久化到浏览器本地数据库

可复用的模板:消息列表与移动端页面

new IndexDb(...) 一行建库的模式非常容易复制。除了名单,项目还有两处持久化场景,都是照搬同一套路:

log-lottery 首页奖品列表页,奖级设置与名单数据均从浏览器本地存储加载

大文件存储:Localforage 独立实例隔离

名单是结构化数据,但配置页上传的背景图、奖品图、背景音乐是 Blob,项目改用 Localforage(底层同样走 IndexedDB),并通过 createInstance 创建独立实例互相隔离:

两个实例与统一清空入口 clearAllDbStore 都集中在 src/utils/localforage/index.ts,配置页一键清数据时即可全部释放。

这套方案新手能借鉴什么

对于数据量小、隐私要求高的纯前端应用,“Dexie + IndexedDB”是一套可以直接抄的作业:

  1. 封装薄门面层:把建表、索引字段、id/时间戳自动补齐收进一个类,业务代码只调方法
  2. 索引字段统一化:每张表带上时间、类型等公共字段,排序筛选永远走索引
  3. 状态与存储双写:内存是真相,存储是快照,启动读库、变更落库
  4. 按数据类型分库:结构化数据用 Dexie,大二进制文件用 Localforage 独立实例

log-lottery 正是靠这套组合拳,让一个“无后端”的网页应用拥有了数据库级的数据可靠性,核心只有一句话:把浏览器本身当作存储层。

登录后查看全文
log-lottery