Drift项目中int64类型在自定义查询中的处理方式

概述

在使用Drift（原Moor）这个Dart/Flutter的SQLite数据库库时，开发者可能会遇到一个关于int64类型处理的有趣问题。当执行自定义SQL查询时，int64类型的列会返回Dart的int类型而非预期的BigInt类型。本文将深入探讨这一现象的原因及解决方案。

现象描述

在Drift项目中定义了一个包含Int64Column的表后，如果通过自定义SQL查询该列，返回的结果会是Dart的int类型而非BigInt。例如：

final changes = await runSelect(inner, "SELECT id FROM change_logs", []);
print(changes.first["id"] is BigInt); // 输出false

底层机制分析

这一现象的根本原因在于底层SQLite驱动package:sqlite3在Web环境下的特殊处理方式：

1. 自动类型转换：sqlite3在Web环境下会将数据库中的整数自动转换为JavaScript的Number（对应Dart的double），前提是该数值可以无损地表示为双精度浮点数。

2. 大整数处理：只有当数值过大无法用双精度浮点数精确表示时，才会返回BigInt类型。

3. Drift的类型映射：在常规Drift查询中，Drift会根据表定义中的列类型信息（如Int64Column）自动将返回的数值转换为BigInt。但对于自定义SQL查询，由于缺乏类型上下文，这种自动转换不会发生。

解决方案

当确实需要BigInt类型时，可以采用以下方法进行手动转换：

BigInt toBigInt(dynamic sqlValue) {
  if (sqlValue is BigInt) {
    return sqlValue;
  } else if (sqlValue is int) {
    return BigInt.from(sqlValue);
  } else {
    return BigInt.parse(sqlValue.toString());
  }
}

这个方法可以确保无论底层返回的是int还是BigInt，最终都能得到一致的BigInt类型结果。

最佳实践建议

1. 类型一致性：如果项目中大量使用大整数，建议统一使用BigInt类型以避免潜在的类型混淆问题。

2. 性能考量：对于确定不会超过普通int范围（-2^63到2^63-1）的数值，可以直接使用int类型以获得更好的性能。

3. 自定义查询处理：在编写自定义SQL查询时，应当明确处理可能的类型转换，特别是在涉及大整数运算或比较的场景中。

总结

Drift项目中int64类型在自定义查询中返回int而非BigInt的行为，是底层SQLite驱动在Web环境下优化类型转换的结果。理解这一机制有助于开发者编写更健壮的数据库操作代码，特别是在需要精确处理大整数的场景中。通过适当的类型转换处理，可以确保数据类型在整个应用中的一致性。