Firestore onWrite触发器中change.after.data()返回空的问题

问题重现 #

在Firestore的estabelecimentos/{idLoja}/privado/estoque/produtos/{idProduto}路径上配置onWrite触发器时，发现change.before.data()能正常获取更新前的数据，但change.after.data()返回空值。两段测试代码如下：

可打印日志的代码（但after.data()仍为空） #

export const produtosWrite = functions.firestore.document('estabelecimentos/{idLoja}/privado/estoque/produtos/{idProduto}')
        .onWrite((change, context)=> {
            functions.logger.debug("after:", change.after.data(), change.after.exists);
            return true;
        })

添加exists判断后仍无法获取数据的代码 #

export const produtosWrite = functions.firestore.document('estabelecimentos/{idLoja}/privado/estoque/produtos/{idProduto}')
    .onWrite((change, context)=> {
        if(change.after.exists) {
            functions.logger.debug("after2:", change.after.data());
        }
        return true;
    })

排查方向与解决方法 #

1. 确认触发场景 #

onWrite触发器会在文档创建、更新、删除三种场景下触发：

• 如果是删除操作：change.after.exists为false，不会进入判断分支，此时change.after.data()自然为空
• 如果是更新/创建操作：change.after.exists应为true，若此时data()为空，继续排查以下点

2. 检查函数权限 #

确保Firebase函数的服务账号拥有目标文档的读取权限：

• 默认情况下，函数服务账号（[项目ID]@appspot.gserviceaccount.com）拥有Cloud Datastore User角色，具备读写Firestore的权限
• 如果手动修改过IAM权限，需确认该账号仍能读取estabelecimentos路径下的文档

3. 处理Snapshot的异步读取 #

DocumentSnapshot.data()在某些场景下可能存在缓存问题，可尝试通过异步get()方法重新获取最新快照：

export const produtosWrite = functions.firestore.document('estabelecimentos/{idLoja}/privado/estoque/produtos/{idProduto}')
    .onWrite(async (change, context)=> { // 改为async函数
        if(change.after.exists) {
            const freshSnap = await change.after.get();
            functions.logger.debug("after2:", freshSnap.data());
        }
        return true;
    })

4. 确认文档内容是否被清空 #

若更新操作是将文档所有字段清空，change.after.data()会返回空对象{}而非undefined，可通过日志打印确认具体值

5. 查看完整函数日志 #

前往Firebase控制台的「函数」→「日志」页面，查看change.after.exists的具体值，以及change.after.data()的输出细节，确认是否存在异常场景（比如文档被快速修改/删除）

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