Mongoose中BigInt类型负值解析问题分析与解决方案

在Mongoose ORM库的最新版本8.9.5中，开发者报告了一个关于BigInt类型字段处理负值时出现的解析错误问题。这个问题在7.8.4版本中表现正常，但在升级后出现了异常行为。

问题现象

当使用Mongoose定义包含BigInt类型的Schema时，如果存储的BigInt值为负数，在查询并转换为普通JavaScript对象(使用lean())后，返回的数值会出现错误。具体表现为负值被错误地解析为正数，导致业务逻辑出现异常。

技术背景

BigInt是JavaScript中用于表示大于2^53-1的整数的原始数据类型。在MongoDB中，大整数通常以64位整数(Int64)形式存储。Mongoose通过BSON库与MongoDB交互，需要正确处理JavaScript的BigInt与MongoDB的Int64之间的转换。

问题根源

经过技术分析，这个问题与Mongoose底层依赖的BSON库版本有关。在BSON 6.x及MongoDB驱动6.x版本中，对BigInt的处理方式发生了变化：

1. 默认情况下，BSON库会将64位整数转换为JavaScript的Number类型，这可能导致精度丢失
2. 需要使用useBigInt64: true选项明确告知驱动使用BigInt类型
3. 在文档更新操作中，如果没有正确配置，BigInt值可能会在保存过程中丢失精度

解决方案

对于遇到此问题的开发者，建议采取以下措施：

1. 确保在连接MongoDB时显式启用BigInt支持：

await mongoose.connect(DB_URI, { useBigInt64: true });

2. 对于查询操作，也可以在单个查询中设置选项：

const items = await Model.find().setOptions({ useBigInt64: true }).lean();

3. 如果项目暂时无法升级，可以考虑锁定BSON和MongoDB驱动版本：

"dependencies": {
  "bson": "5.5.0",
  "mongodb": "5.7.0"
}

最佳实践

为避免类似问题，建议开发者在处理大整数时：

1. 始终明确指定数字类型处理方式
2. 在测试用例中覆盖边界值测试，特别是接近64位整数极限的值
3. 在项目文档中记录数字类型处理策略
4. 升级Mongoose版本时，注意检查底层依赖的变更日志

Mongoose团队已经确认此问题并计划在后续版本中改进相关处理逻辑，使BigInt类型的处理更加直观和可靠。