Firebase定时删除集合触发UNAUTHENTICATED错误求助

1. 给定时任务的服务账号加权限 #

Cloud Scheduler底层使用的是service-{PROJECT_NUMBER}@gcp-sa-cloudscheduler.iam.gserviceaccount.com这个服务账号，必须给它添加调用Cloud Functions的权限：

• 打开Google Cloud Console的IAM与管理员页面
• 找到该服务账号，添加Cloud Functions Invoker角色

2. 正确初始化Firebase Admin SDK #

别手动指定凭据——手动运行时你可能用了本地凭据，但定时触发走的是云环境默认服务账号。初始化代码就这么写：

const admin = require('firebase-admin');
admin.initializeApp(); // 不传任何参数，云环境会自动使用默认服务账号

3. 确保函数服务账号能删除Firestore集合 #

Cloud Functions默认使用{PROJECT_ID}@appspot.gserviceaccount.com这个账号，得让它拥有Firestore的删除权限：

• 打开Firebase Console的Firestore页面，点击规则标签
• 调整规则允许该账号删除集合，比如：

match /{document=**} {
  allow delete: if request.auth.token.email == "{PROJECT_ID}@appspot.gserviceaccount.com";
}

测试阶段可以临时设为allow delete: if true;，上线前记得改回严格规则

4. 检查Cloud Scheduler的触发配置 #

• 打开Google Cloud Console的Cloud Scheduler页面，找到你的定时任务
• 确认目标类型为HTTP，URL是Cloud Functions的触发地址
• 身份验证选择服务账号，且选中的是拥有Cloud Functions Invoker权限的账号（比如第一步中的Cloud Scheduler服务账号）

日志排查技巧 #

如果还是报错，去看详细日志找具体原因：

• 打开Google Cloud Console的Cloud Functions页面，找到对应函数点击日志
• 搜索UNAUTHENTICATED关键词，查看前后上下文信息

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