OPFS 与 IndexedDB 浏览器端文件系统实践（进阶指南）

`title: OPFS 与 IndexedDB 浏览器端文件系统实践（进阶指南）``categories: Web 开发/前端/数据管理``keywords: OPFS,IndexedDB,FileSystemSyncAccessHandle,IDBKeyRange,离线,性能``description: 面向复杂场景的组合实践：用 IndexedDB 管理结构化元数据、OPFS 存储大文件，在 Service Worker 和 Worker 下实现高性能与离线可靠性。`设计原则结构化数据用 IndexedDB；大文件与二进制用 OPFS；配合 SW 缓存网络与文档。主线程只做协调；重 IO 放在 Worker；持久层采用幂等与断点续传。元数据与索引`items(id)` 主键；索引 `byUserId`、`byCreatedAt`；范围查询用于时间窗与分页。大文件存储（OPFS）主线程小文件走 `createWritable`；大文件在 Worker 使用 `SyncAccessHandle` 同步写并 `flush`。断点续传示例// 记录块信息到 IndexedDB，数据块写入 OPFS // 通过块哈希校验避免重复写入；失败块重试与重放 离线与重放SW 捕获失败请求入队；网络恢复后重放；队列存 IndexedDB，业务数据与文件分层处理。清理与配额定期清理无引用文件；按用户与时间窗归档；尊重配额限制与隐私模式降级。