Firebase Update遇前导字母元素含非字母数字字符异常问题

问题根源 #

Firestore 使用点分隔的路径字符串（如clients.{uid}.status）执行update操作时，会对路径中的每个字段段做格式校验：

• 若字段名以字母开头，则必须仅包含字母、数字和下划线（_），不允许横杠（-）这类非字母数字字符；
• 若字段名以数字开头，则不受上述标识符规则限制，横杠等特殊字符可正常识别。

你的第一个用户IDa994f7df-47c5-4e8a-941e-2d080292694a以字母a开头且包含横杠，触发了校验报错；第二个ID086aac5a-9087-40d1-b078-1273d5663067以数字0开头，因此能通过校验。

而set({}, merge=True)可正常执行，是因为该方法接受嵌套字典结构（而非路径字符串），Firestore会直接写入整个对象，不会解析点路径，自然不会触发字段名格式校验。

解决方案 #

无需对用户ID做字符串清理，只需修改update的调用方式，避开点路径字符串即可：

方案1：使用嵌套字典

db.collection(u'clientsMap').document(tid).update({
    'clients': {
        uid: {
            'status': True
        }
    }
})

方案2：使用FieldPath构建合法路径

from google.cloud.firestore import FieldPath

# 构建嵌套字段路径
field_path = FieldPath('clients', uid, 'status')
db.collection(u'clientsMap').document(tid).update({
    field_path: True
})

两种方式都能绕过点路径的格式校验，直接处理包含特殊字符的字段名。

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