如何在浏览器中为Firestore使用64位整数且避免精度丢失？

Firestore支持存储64位有符号整数，但JavaScript的number类型仅能精确表示53位以内的数值，针对你遇到的BigInt客户端不支持、字符串无法排序的问题，提供以下可行方案：

方案1：使用Firestore客户端SDK的Int64包装类 #

当前客户端SDK虽不支持直接读写原生BigInt，但提供了Int64类型来封装64位整数，既保证精度，又能让Firestore正常执行排序操作。

• 写入示例：

  import { getFirestore, doc, setDoc, Int64 } from "firebase/firestore";
  
  const db = getFirestore();
  // 用Int64包装大整数（支持传入字符串或BigInt）
  const largeInt = new Int64("1234567890123456789");
  await setDoc(doc(db, "your-collection", "your-doc"), {
    bigNumber: largeInt
  });
  

• 读取示例：

  import { getFirestore, doc, getDoc } from "firebase/firestore";
  
  const db = getFirestore();
  const docSnap = await getDoc(doc(db, "your-collection", "your-doc"));
  if (docSnap.exists()) {
    const int64Value = docSnap.data().bigNumber;
    // 转换为BigInt使用
    const bigIntVal = int64Value.toBigInt();
    // 或转换为字符串
    const strVal = int64Value.toString();
  }
  

方案2：拆分整数为高低位存储（兼容旧版SDK） #

若你使用的是无Int64类的旧版SDK，可将64位整数拆分为两个32位整数（高位+低位）存储，读写时再组合还原，排序时按高位优先、低位次之的逻辑处理。

• 拆分写入示例：

  function splitTo32Bits(numStr) {
    const bigNum = BigInt(numStr);
    return {
      high: Number(bigNum >> 32n),
      low: Number(bigNum & 0xFFFFFFFFn)
    };
  }
  
  await setDoc(doc(db, "your-collection", "your-doc"), {
    bigNumber: splitTo32Bits("1234567890123456789")
  });
  

• 组合读取示例：

  function combineFrom32Bits(high, low) {
    return (BigInt(high) << 32n) | BigInt(low);
  }
  
  const docSnap = await getDoc(doc(db, "your-collection", "your-doc"));
  if (docSnap.exists()) {
    const { high, low } = docSnap.data().bigNumber;
    const fullBigInt = combineFrom32Bits(high, low);
  }
  

关于Admin与客户端SDK的差异 #

Admin SDK基于Node.js环境，对BigInt的支持更完善；而客户端SDK需兼顾浏览器兼容性（部分旧浏览器不支持BigInt），因此未直接开放原生BigInt读写，但通过上述Int64方案可覆盖需求。

内容的提问来源于stack exchange，提问作者secretshardul