Android端Firestore如何更新键含英文句号(.)的字段？

这个问题我之前踩过坑！Firestore处理带点号的字段名确实有个容易忽略的细节，你的场景里首次set成功创建字段，但后续update却生成嵌套字段，核心原因是：Firestore默认会把字符串形式的字段名里的点号解析成嵌套字段的分隔符。

问题根源 #

当你用update("com.example.android", value)时，Firestore会把这个字符串当成com -> example -> android的嵌套路径，而非一个完整的字段键，所以会生成新的嵌套结构，而不是更新你之前用set创建的那个带点号的字段。

正确解决方案：用FieldPath指定完整字段键 #

要让Firestore识别这是一个带点号的独立字段，你需要用FieldPath对象来包装字段名，明确告诉它这是一个完整的字段键，不是嵌套路径。结合你的场景（文档不存在则创建，存在则更新），推荐使用set(merge=true)而非单纯的update，因为update在文档不存在时会报错，而set(merge=true)可以完美实现“创建或更新”的需求。

Kotlin代码示例

val db = FirebaseFirestore.getInstance()
val targetDoc = db.collection("your-collection-name").document("your-document-id")

// 用FieldPath包装带点号的字段名
val dotFieldKey = FieldPath.of("com.example.android")
val updateData = hashMapOf(
    dotFieldKey to "your-updated-value" // 这里可以是任意合法值：字符串、数字、对象等
)

// 使用set+merge选项，实现不存在则创建，存在则更新
targetDoc.set(updateData, SetOptions.merge())
    .addOnSuccessListener {
        // 处理成功逻辑，比如Toast提示
    }
    .addOnFailureListener { e ->
        // 处理失败逻辑，比如打印错误日志
        e.printStackTrace()
    }

Java代码示例

FirebaseFirestore db = FirebaseFirestore.getInstance();
DocumentReference targetDoc = db.collection("your-collection-name").document("your-document-id");

// 创建FieldPath对象指定带点号的字段
FieldPath dotFieldKey = FieldPath.of("com.example.android");
Map<String, Object> updateData = new HashMap<>();
updateData.put(dotFieldKey, "your-updated-value");

// 调用set方法并传入merge选项
targetDoc.set(updateData, SetOptions.merge())
    .addOnSuccessListener(aVoid -> {
        // 成功回调
    })
    .addOnFailureListener(e -> {
        // 失败回调，打印错误信息
        e.printStackTrace();
    });

补充说明 #

• 如果你确定文档已经存在，只想更新字段，也可以用update方法，但同样需要传入FieldPath对象，比如targetDoc.update(dotFieldKey, newValue)。
• 首次set成功是因为当时你是直接将带点号的键作为Map的key传入，set方法默认会将其视为普通字段（除非你明确使用嵌套路径语法），而update方法对字符串键的解析规则更严格，必须用FieldPath来规避嵌套解析。

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