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"错误。

问题现象

在升级到Dexie 4.0.8后，以下查询代码在某些情况下会抛出异常：

await this.table("table")
    .where({foreignKey1: "1", foreignKey2: "1"})
    .toArray()

当数据表中存在foreignKey1有值但foreignKey2为null的记录时，就会触发上述错误。有趣的是，只需简单地调换查询条件的顺序，问题就能暂时解决：

await this.table("table")
    .where({foreignKey2: "1", foreignKey1: "1"})
    .toArray()

技术原理

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

在Dexie 3.x版本中，查询处理逻辑可能采用了不同的比较机制，或者对null值有特殊处理，因此不会出现这个问题。升级到4.x后，内部实现发生了变化，直接暴露了底层IndexedDB的这个限制。

解决方案

Dexie团队已经识别出这个问题，并提出了以下改进方案：

1. 不再直接使用IDBFactory.cmp()方法，而是改用Dexie内部实现的cmp.ts比较函数
2. 内部比较函数对null值的处理更加宽容，会返回NaN而不是抛出异常
3. 内部比较函数的性能实际上比原生IndexedDB的cmp()更好

最佳实践

对于开发者而言，在等待官方修复版本发布前，可以采取以下临时解决方案：

1. 调整查询条件的顺序，将可能为null的字段放在后面
2. 确保查询条件中不会出现null值
3. 考虑添加复合索引来优化查询性能

版本更新

该问题已在Dexie.js的主分支中修复，预计会包含在下一个发布版本中。开发者可以关注官方更新，及时升级到修复后的版本。

总结

这个问题展示了数据库抽象层在处理底层API边界条件时面临的挑战。Dexie团队通过替换比较函数的实现，既解决了兼容性问题，又提升了性能，体现了良好的设计决策。对于开发者而言，理解这类问题的本质有助于更好地使用数据库工具，并在遇到类似问题时能够快速定位和解决。