IndexedDB 是浏览器端适合音乐类应用的本地数据库，支持事务、索引与 Blob 存储，需分 playlists 和 downloads 仓库管理，通过版本升级、事务写入、索引查询及错误降级保障离线播放可靠性。

IndexedDB 是浏览器端强大的本地数据库，适合存储结构化数据，比如音乐播放列表和下载状态。它支持事务、索引、大容量二进制数据（如音频文件 Blob），且能离线工作，非常适合音乐类应用的缓存需求。

初始化数据库并创建对象仓库

首次打开数据库时需定义版本与结构。播放列表和下载状态建议分两个对象仓库管理，便于独立读写与更新。

• 使用 indexedDB.open("musicDB", 2) 打开或升级数据库（版本号递增触发 upgrade 事件）
• 在 onupgradeneeded 中创建 playlists 仓库（主键为 playlistId），添加索引如 userId 方便按用户查询
• 同时创建 downloads 仓库（主键为 trackId），添加 status（"pending"/"completed"/"failed"）和 file（Blob 类型，可存音频文件或仅 URL）字段
• 注意：Blob 可直接存入 IndexedDB，但需确保在同源上下文中创建（避免跨域 Blob 导致序列化失败）

保存与更新播放列表

播放列表通常包含 id、name、trackIds 数组、更新时间等字段。写入时推荐使用事务保证一致性。

librosa Python 音频与音乐分析库

librosa 是一个用于音频和音乐分析的 Python 库。它提供了特征提取、频谱分析、节拍跟踪、起始检测和音频可视化的工具，基于 NumPy 和 SciPy 构建，用于科学音频计算。

下载

• 调用 db.transaction(["playlists"], "readwrite") 获取仓库
• 用 store.put({id: "pl_123", name: "我的最爱", trackIds: ["t1","t2"], updatedAt: Date.now()}) 写入或覆盖
• 若需批量更新多个列表，可在同一事务中多次调用 put，避免频繁开闭事务
• 查询时可用 store.index("userId").getAll(ID) 快速获取某用户所有列表

管理单曲下载状态与缓存音频文件

下载状态需实时反映进度与结果；已下载音频应尽量缓存为 Blob，减少重复请求。

立即学习“Java免费学习笔记（深入）”；

• 开始下载前先写入初始状态：downloads.put({trackId: "t1", status: "pending", progress: 0})
• 下载完成时更新为 {status: "completed", file: blob, size: blob.size, downloadedAt: Date.now()}
• 播放时优先从 downloads.get("t1") 读取 Blob，用 URL.createObjectURL(blob) 创建可播放的 src
• 注意：createObjectURL 生成的 URL 需手动 revoke（如页面卸载或切换歌曲后），否则内存泄漏

错误处理与降级策略

IndexedDB 操作可能失败（如用户禁用、磁盘满、版本冲突），需有兜底逻辑。

• 所有请求监听 onsuccess / onerror，失败时记录日志并 fallback 到内存 Map 或 localStorage（仅存轻量元数据）
• 对大文件下载，可先存 metadata 到 IndexedDB，再将 Blob 分块写入（用 put() 分多次提交，避免单次过大阻塞）
• 监听 blocked 事件，提示用户关闭其他标签页以完成数据库升级
• 定期清理过期下载项（如 30 天未使用），用游标遍历 + 条件删除

实际使用中，配合 Service Worker 可进一步实现后台下载与推送更新，但 IndexedDB 本身已足够支撑离线播放核心场景。关键不是存多少，而是结构清晰、读写可控、失败可退。