无需后端的数据存储方案:log-lottery如何用Dexie+IndexedDB实现浏览器本地持久化
无需后端的数据存储方案: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:
- store 创建即读库:Pinia store 初始化时先从本地数据库按
createTime排序读出全部名单,回填到内存状态 - 每次操作双写:添加人员、标记中奖、删除、重置等每个 action,都先更新内存 ref,再调用
personDb的对应方法同步落库
这套“内存 + 本地库”双写模式是抽奖体验流畅的关键——屏幕上的 3D 球体滚动读取的是毫秒级响应的内存数据,而 IndexedDB 在背后默默保证“断电不丢”。抽奖结束时,中奖人的奖品名、中奖时间会被写回名单(见 src/store/personConfig.ts#L79-L100 的回写逻辑),下次打开页面结果依然可查。
可复用的模板:消息列表与移动端页面
new IndexDb(...) 一行建库的模式非常容易复制。除了名单,项目还有两处持久化场景,都是照搬同一套路:
- 控制台操作消息:src/views/Config/Server/useViewModel.ts 用
new IndexDb('msgList', ['msgList'], 1, ['createTime'])保存抽奖台的操作记录,刷新后仍可回看 - 移动端互动消息:src/views/Mobile/useViewModel.ts 中的
userMsgDb把手机发送的消息本地存档,按时间排序读出
大文件存储:Localforage 独立实例隔离
名单是结构化数据,但配置页上传的背景图、奖品图、背景音乐是 Blob,项目改用 Localforage(底层同样走 IndexedDB),并通过 createInstance 创建独立实例互相隔离:
imgStore:存放自定义背景、头像、奖品图等,如 src/views/Config/Prize/usePrizeConfig.ts 中的奖品图片读取audioStore:存放上传的背景音乐,src/layout/RightButton/usePlayMusic.ts 播放时优先读取本地存档的音频
两个实例与统一清空入口 clearAllDbStore 都集中在 src/utils/localforage/index.ts,配置页一键清数据时即可全部释放。
这套方案新手能借鉴什么
对于数据量小、隐私要求高的纯前端应用,“Dexie + IndexedDB”是一套可以直接抄的作业:
- 封装薄门面层:把建表、索引字段、id/时间戳自动补齐收进一个类,业务代码只调方法
- 索引字段统一化:每张表带上时间、类型等公共字段,排序筛选永远走索引
- 状态与存储双写:内存是真相,存储是快照,启动读库、变更落库
- 按数据类型分库:结构化数据用 Dexie,大二进制文件用 Localforage 独立实例
log-lottery 正是靠这套组合拳,让一个“无后端”的网页应用拥有了数据库级的数据可靠性,核心只有一句话:把浏览器本身当作存储层。


