Dexie.js数据库索引变更异常问题分析与解决方案

问题现象描述

在使用Dexie.js进行IndexedDB数据库操作时，开发者遇到了一个奇怪的错误提示："Not yet support for changing the primary key"(尚不支持更改主键)。这个错误出现在开发者仅尝试添加普通索引的情况下，而非实际修改主键。

问题复现与排查

最初开发者尝试通过简单的代码复现该问题：创建一个包含"users"表的数据库，初始定义包含"++id"主键和"firstName"索引，随后在不改变版本号的情况下添加"lastName"索引。有趣的是，问题在不同浏览器和设备上表现不一致：

1. 在PC端(Chrome/Ubuntu)上，错误偶尔出现，但刷新页面后可能消失
2. 在Android Chrome上错误持续存在
3. Firefox浏览器则完全不会出现该错误

深入分析与发现

进一步分析发现，控制台会输出两条关键日志信息：

1. "Dexie SchemaDiff: Schema was extended without increasing the number passed to db.version()..." - 表示在不增加版本号的情况下扩展了模式
2. "Unable to patch indexes of table foo because it has changes on the type of index or primary key" - 指向一个名为"foo"的旧表存在问题

开发者注意到"foo"表的定义使用了复合索引"[a+b+c],b,d,a"这种特殊语法，而这个表实际上已经不再使用。当从模式中移除此表定义后，问题得到彻底解决。

技术背景解析

IndexedDB作为浏览器端的NoSQL数据库，对模式变更有着严格的要求。Dexie.js作为其封装库，提供了更友好的API，但在处理模式变更时仍需遵循底层规则：

1. 版本控制机制：IndexedDB要求每次模式变更都应增加版本号
2. 索引类型限制：复合索引与普通索引有本质区别，不能随意转换
3. 浏览器兼容性：不同浏览器对IndexedDB的实现存在细微差异

解决方案与最佳实践

基于此案例，我们总结出以下解决方案和最佳实践：

1. 完整清理旧表定义：移除不再使用的表定义，特别是那些使用特殊索引语法的表
2. 显式版本管理：每次模式变更都应明确增加版本号
3. 错误处理机制：实现重试逻辑处理可能的临时错误
4. 开发环境检查：在开发阶段仔细检查控制台输出的Dexie警告信息

// 推荐的重试机制示例
try {
  await db.open();
} catch(e) {
  console.error(e);
  await db.open(); // 简单重试
}

总结与建议

这个案例展示了在使用Dexie.js时可能遇到的隐式模式变更问题。虽然Dexie.js提供了灵活的模式扩展能力，但开发者仍需注意：

1. 保持模式定义的整洁性，及时清理废弃定义
2. 遵循显式版本变更原则
3. 在不同浏览器和设备上进行充分测试
4. 关注控制台输出的警告信息

通过遵循这些实践，可以避免类似"Not yet support for changing the primary key"这样的隐式错误，确保应用在不同环境下都能稳定运行。