解决Firestore触发邮件扩展中的“Error: No Recipients Defined”错误

问题根源 #

这个错误是因为SendGrid扩展无法从sendgrid_users集合的文档中读取到有效邮箱地址，大概率是文档结构或扩展配置不匹配导致的。

具体修复步骤 #

• 确认sendgrid_users文档的字段结构
  你的UID对应的文档里必须包含存储邮箱的字段，默认情况下扩展会读取email字段。示例文档结构如下：

  {
    "email": "目标用户的邮箱@xxx.com"
  }
  

  如果你用了其他字段名（比如user_email），后续需要在扩展配置里同步修改。

• 重新配置SendGrid扩展的邮箱字段
  打开Firebase控制台的扩展页面，找到SendGrid扩展进入配置界面：

  1. 找到“User email field”选项
  2. 确保这里填写的字段名和sendgrid_users文档里存储邮箱的字段完全一致（默认是email）
  3. 保存配置变更

• 验证UID的准确性
  检查mail集合新文档的to字段填写的UID，是否和sendgrid_users集合里的文档ID完全一致——Firestore的文档ID是大小写敏感的，任何拼写错误都会导致扩展找不到对应的邮箱。

• 检查扩展的读取权限
  确保SendGrid扩展的服务账号拥有读取sendgrid_users集合的权限，可以在Firestore规则或扩展权限设置里验证。

额外排查技巧 #

如果问题仍未解决，去Firebase控制台的扩展日志里查看详细错误信息，扩展会明确提示是找不到文档还是找不到邮箱字段，根据提示调整即可。

内容的提问来源于stack exchange，提问作者Chris T.