如何通过Unity删除Firestore字段？已尝试文档示例无效，求解决方案

先确认前提 #

确保你使用的是最新版本的Firebase Unity SDK，旧版本可能存在FieldValue.Delete()的兼容性问题。

正确实现代码示例 #

Firestore删除指定字段的核心是使用FieldValue.Delete()标记要移除的字段，再通过UpdateAsync()提交更新。以下是完整的可运行代码：

using Firebase.Firestore;
using UnityEngine;

public class FirestoreFieldManager : MonoBehaviour
{
    private FirebaseFirestore _firestoreDb;

    void Start()
    {
        // 初始化Firebase依赖（如果项目未完成初始化）
        Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task =>
        {
            if (task.IsCompletedSuccessfully)
            {
                _firestoreDb = FirebaseFirestore.DefaultInstance;
                DeleteTargetField();
            }
            else
            {
                Debug.LogError($"Firebase初始化失败: {task.Exception}");
            }
        });
    }

    private void DeleteTargetField()
    {
        // 替换为你的集合名和文档ID
        DocumentReference targetDoc = _firestoreDb.Collection("your-collection-name").Document("target-document-id");

        // 构建更新字典，指定要删除的字段
        var updateData = new Dictionary<string, object>
        {
            // 替换为你要删除的字段名；嵌套字段用点分隔，比如["user.settings.notifications"]
            ["field-to-remove"] = FieldValue.Delete()
        };

        // 执行异步更新并处理结果
        targetDoc.UpdateAsync(updateData).ContinueWith(task =>
        {
            if (task.IsCompletedSuccessfully)
            {
                Debug.Log("指定字段删除成功");
            }
            else
            {
                Debug.LogError($"字段删除失败: {task.Exception}");
            }
        });
    }
}

基于Async/Await的简化写法（Unity 2018.3+支持） #

如果项目支持C# async/await，可使用更简洁的写法：

private async void DeleteFieldAsync()
{
    try
    {
        DocumentReference targetDoc = _firestoreDb.Collection("your-collection").Document("your-document");
        await targetDoc.UpdateAsync(new Dictionary<string, object>
        {
            ["field-to-delete"] = FieldValue.Delete()
        });
        Debug.Log("字段删除成功");
    }
    catch (System.Exception ex)
    {
        Debug.LogError($"删除失败: {ex.Message}");
    }
}

常见问题排查 #

• 字段路径错误：嵌套字段需用点分隔（如["user.profile.age"]），拼写错误会导致操作无效果
• 异步操作未等待：直接调用UpdateAsync()不处理回调/await，可能代码执行完但操作未提交
• 权限不足：检查Firestore安全规则，确保当前用户拥有目标文档的写权限
• 文档不存在：如果目标文档未创建，UpdateAsync()不会报错但也不会产生任何变化，需先确认文档存在
• SDK版本过旧：前往Firebase控制台下载最新Unity SDK，替换项目中的旧SDK文件

内容的提问来源于stack exchange，提问作者André Ramiro