如何删除Firestore文档所有字段且保留空文档？

Firestore没有专门的单条命令直接清空文档所有字段，但可以通过两种简单方式实现需求，同时保留文档本身：

方法1：用set方法替换为空文档（推荐） #

这种方式直接将文档内容替换为空对象，一次性清空所有字段，效率最高，适合字段数量不确定或较多的场景。

Admin SDK（Node.js） #

const admin = require('firebase-admin');
admin.initializeApp();

const db = admin.firestore();
const docRef = db.collection('你的集合名').doc('你的文档ID');

// 执行清空操作
docRef.set({}, { merge: false })
  .then(() => console.log('文档所有字段已清空'))
  .catch(err => console.error('清空操作失败:', err));

Web客户端SDK #

import { getFirestore, doc, setDoc } from "firebase/firestore";

const db = getFirestore();
const docRef = doc(db, "你的集合名", "你的文档ID");

// 执行清空操作
setDoc(docRef, {}, { merge: false })
  .then(() => console.log('文档所有字段已清空'))
  .catch(err => console.error('清空操作失败:', err));

方法2：逐个删除字段（适合已知所有字段名的场景） #

如果明确知道文档的所有字段名，可以用update方法配合FieldValue.delete()逐个删除字段：

Admin SDK示例 #

const admin = require('firebase-admin');
admin.initializeApp();

const db = admin.firestore();
const docRef = db.collection('你的集合名').doc('你的文档ID');

// 逐个删除字段
docRef.update({
  fieldName1: admin.firestore.FieldValue.delete(),
  fieldName2: admin.firestore.FieldValue.delete(),
  // 继续添加其他需要删除的字段
})
.then(() => console.log('指定字段已删除'))
.catch(err => console.error('删除失败:', err));

注意：set({}, { merge: false })会完全替换文档内容，执行后文档仅保留空对象结构；而逐个删除字段的方式，需确保列出所有存在的字段，否则未列出的字段会保留。

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