Firestore定时删除过期历史文档失败，请求排查问题

核心错误：数据类型不匹配 #

你的代码中用Date.now()生成的是毫秒级时间戳（数字类型），但如果Firestore中存储的lastModified是官方的Timestamp类型（而非纯数字时间戳），直接用数字和Timestamp比较会导致查询不匹配，这就是historySnapshot.size始终为0的原因。

修复步骤 #

1. 将cutoff转换为Firestore Timestamp类型 #

把基于毫秒的时间阈值转换为Firestore认可的Timestamp对象，确保和字段类型一致：

const now = new Date();
const cutoff = new Date(now.getTime() - 24 * 60 * 60 * 1000); // 24小时前的Date对象
const cutoffTimestamp = admin.firestore.Timestamp.fromDate(cutoff);

2. 修改查询条件使用Timestamp #

将查询中的cutoff替换为转换后的cutoffTimestamp：

const historySnapshot = await historyRef.where("lastModified", "<", cutoffTimestamp).get();

3. 修复模板字符串语法错误 #

你的console.log用了双引号包裹模板字符串，变量无法被解析，需要改成反引号：

console.log(`Deleted ${numDocsDeleted} history documents for user ${userDoc.id}`);

完整修复后的代码 #

exports.deleteOldHistoryDocuments = functions.pubsub.schedule("every 1 hours").onRun(async (context) => {
    const now = new Date();
    const cutoff = new Date(now.getTime() - 24 * 60 * 60 * 1000); // 24小时前的时间点
    const cutoffTimestamp = admin.firestore.Timestamp.fromDate(cutoff);

    const usersRef = admin.firestore().collection("users");
    const usersSnapshot = await usersRef.get();

    let totalDocsDeleted = 0;

    // 遍历所有用户文档
    for (const userDoc of usersSnapshot.docs) {
        console.log("Processing user: ", userDoc.id);
        const historyRef = userDoc.ref.collection("history");
        const historySnapshot = await historyRef.where("lastModified", "<", cutoffTimestamp).get();
        const numDocsDeleted = historySnapshot.size;

        if (numDocsDeleted > 0) {
            const batch = admin.firestore().batch();
            historySnapshot.docs.forEach((doc) => {
                batch.delete(doc.ref);
            });

            await batch.commit();

            console.log(`Deleted ${numDocsDeleted} history documents for user ${userDoc.id}`);
            totalDocsDeleted += numDocsDeleted;
        }
    }

    console.log("Total documents deleted: " + totalDocsDeleted);
});

额外检查点 #

• 确认lastModified字段类型：如果你的代码中是用Date对象直接写入的，Firestore会自动转成Timestamp；如果是手动存储的毫秒/秒级数字，需要调整cutoff为对应单位的数值（比如存秒级时间戳的话，cutoff要除以1000）。
• 检查Firestore规则：确保触发器拥有读取和删除users/{userId}/history文档的权限。

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