Dexie.js 4.0 版本中IDBFactory.cmp()参数校验问题解析

问题背景

Dexie.js作为一款优秀的IndexedDB封装库，在4.0.8版本中出现了一个关于键值比较的边界情况处理问题。当开发者使用复合条件查询时，如果查询条件中包含null值，会触发"Failed to execute 'cmp' on 'IDBFactory': The parameter is not a valid key"的错误。

问题现象

具体表现为：当执行类似where({foreignKey1: "1", foreignKey2: "1"})的查询时，如果数据库中某些记录的foreignKey2字段为null，就会抛出上述错误。有趣的是，通过简单地调换查询条件的顺序（如改为where({foreignKey2: "1", foreignKey1: "1"})）可以暂时规避这个问题。

技术分析

这个问题的根源在于Dexie.js内部使用了IndexedDB原生的IDBFactory.cmp()方法进行键值比较。根据IndexedDB规范，cmp()方法不接受null作为有效键值参数，当遇到null时会抛出异常。

在Dexie.js 3.2.6版本中可能使用了不同的比较机制，或者对null值有特殊处理，因此没有出现这个问题。升级到4.0.8版本后，内部实现发生了变化，暴露出了这个边界情况。

解决方案

Dexie.js开发团队已经修复了这个问题，具体措施是：

1. 弃用原生的IDBFactory.cmp()方法
2. 改用内部实现的cmp.ts比较函数
3. 新的比较函数对null值的处理更加宽容，会返回NaN而不是抛出异常

这种改进不仅解决了null值比较的问题，还带来了性能上的提升，因为内部实现的比较函数比原生IndexedDB的实现效率更高。

最佳实践

对于使用Dexie.js的开发者，建议：

1. 如果遇到类似问题，可以暂时通过调整查询条件顺序来规避
2. 及时升级到包含修复的版本
3. 在设计数据库schema时，考虑清楚字段是否允许为null
4. 对于可能为null的字段，在查询时进行适当的null检查

总结

这个问题展示了在数据库抽象层开发中处理边界情况的重要性。Dexie.js团队通过改用更灵活的内部比较函数，不仅解决了特定场景下的错误，还提升了整体性能。对于开发者而言，理解底层IndexedDB的约束条件有助于设计更健壮的应用程序。