Dexie.js数据库主键变更问题的分析与解决

问题背景

在使用Dexie.js这个IndexedDB封装库时，开发者可能会遇到一个"Not yet support for changing the primary key"(尚未支持更改主键)的错误提示。这个错误看似简单，但实际上可能由多种因素引起，需要深入理解Dexie.js的版本管理和索引变更机制。

问题现象

开发者在不修改数据库版本号的情况下，仅向表结构中添加普通索引时，意外触发了主键变更的错误提示。具体表现为：

1. 在PC端(Chrome浏览器)上，错误有时出现，有时又会在页面刷新后消失
2. 在Android设备上，错误稳定重现
3. 在Firefox浏览器上，错误完全不会出现

根本原因分析

经过深入排查，发现问题的根源在于：

1. 版本管理不当：开发者没有增加版本号就修改了表结构，这违反了Dexie.js的版本管理原则
2. 遗留表结构问题：数据库中有一个名为"foo"的旧表，其索引结构为复合索引"[a+b+c],b,d,a"，这个表在之前的版本中可能有不同的定义
3. 浏览器缓存差异：不同浏览器和设备对IndexedDB的缓存处理方式不同，导致问题表现不一致

Dexie.js的版本管理机制

Dexie.js通过版本号来管理数据库结构变更。当需要修改表结构时，必须：

1. 增加版本号
2. 在新的版本中定义新的表结构
3. Dexie.js会自动处理数据迁移

如果不增加版本号就修改表结构，Dexie.js会尝试"智能"地处理变更，但这种行为在不同浏览器中可能表现不一致。

解决方案

1. 规范版本管理：每次修改表结构时，都应该增加版本号

// 错误的做法 - 不增加版本号
db.version(1).stores({ users:"++id,firstName,lastName" });

// 正确的做法 - 增加版本号
db.version(2).stores({ users:"++id,firstName,lastName" });

2. 清理遗留表结构：移除不再使用的旧表定义，避免干扰

3. 错误处理机制：对于可能出现的错误，可以添加重试逻辑

try {
  await db.open();
} catch(e) {
  console.error(e);
  await db.open(); // 重试一次
}

最佳实践建议

1. 始终遵循Dexie.js的版本管理规范，每次修改表结构都增加版本号
2. 在开发过程中定期清理测试数据库，避免遗留表结构干扰
3. 为数据库操作添加适当的错误处理和重试机制
4. 在不同浏览器和设备上进行充分测试，确保兼容性

总结

Dexie.js作为IndexedDB的封装库，虽然简化了前端数据库操作，但仍然需要开发者理解其版本管理和索引变更机制。通过规范版本管理和清理遗留结构，可以有效避免"主键变更"这类错误的发生。对于复杂的应用场景，建议建立完善的数据库变更管理流程，确保数据结构的稳定性和兼容性。