如何将自增ID转换为类Firestore格式ID以避免热点问题？

一、生成符合格式的哈希方案 #

Firestore文档ID要求匹配正则^[a-zA-Z0-9]{20}$，你可以基于自增ID生成符合要求的ID，以下是两种可行实现方式：

1. 哈希截断+补位 #

用SHA-256哈希处理自增ID，通过Base64编码转换为合法字符集，再截断或补位到20位：

import hashlib
import base64
import string
import random

def generate_firestore_id(auto_increment_id):
    # 自增ID转字节并生成哈希
    id_bytes = str(auto_increment_id).encode('utf-8')
    hash_bytes = hashlib.sha256(id_bytes).digest()
    # Base64编码并替换非法字符
    base64_str = base64.b64encode(hash_bytes).decode('utf-8').replace('+', 'X').replace('/', 'Y').rstrip('=')
    # 截取前20位，不足则补随机合法字符
    firestore_id = base64_str[:20]
    if len(firestore_id) < 20:
        chars = string.ascii_letters + string.digits
        firestore_id += ''.join(random.choice(chars) for _ in range(20 - len(firestore_id)))
    return firestore_id

SHA-256的碰撞概率可忽略，能保证ID唯一性，同时完全符合Firestore格式要求。

2. 自增ID转62进制补位 #

将自增数字转为62进制（包含0-9、a-z、A-Z），再在前面补随机合法字符凑够20位：

import string
import random

BASE62 = string.digits + string.ascii_lowercase + string.ascii_uppercase

def num_to_base62(num):
    if num == 0:
        return BASE62[0]
    base62 = []
    while num > 0:
        num, rem = divmod(num, 62)
        base62.append(BASE62[rem])
    return ''.join(reversed(base62))

def generate_firestore_id(auto_increment_id):
    base62_str = num_to_base62(auto_increment_id)
    pad_length = 20 - len(base62_str)
    if pad_length > 0:
        pad_chars = ''.join(random.choice(BASE62) for _ in range(pad_length))
        firestore_id = pad_chars + base62_str
    else:
        firestore_id = base62_str[:20]
    return firestore_id

这种方式保留了自增ID的唯一性，通过前缀随机完全分散写入热点，同时严格匹配格式要求。

二、替代策略：无需哈希的热点规避方案 #

除了哈希自增ID，还有更直接的方式避免Firestore写入热点：

• 使用Firestore自动生成ID：写入文档时不指定ID，让Firestore自动生成随机20位合法ID，彻底规避热点问题。只需在文档中存储原自增ID字段，用于后续关联查询。
• 自增ID反转+随机后缀：将自增ID转为字符串后反转，再拼接随机合法字符凑够20位。比如自增ID1234反转后为4321，再加上16位随机字符，让写入ID前缀分散。
• 分桶前缀策略：给每个文档添加1-100范围内的随机分桶前缀（转成两位合法字符），再拼接自增ID，比如0X1234（调整为符合格式的字符串），让写入请求分散到不同存储分片，缓解热点。

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