Firebase Trigger Email报Missing credentials for PLAIN的认证配置方法？

报错根因 #

Error: Missing credentials for "PLAIN" 不是你存在Firestore里的邮件文档缺字段，是Trigger Email扩展本身没有配置SMTP服务的有效认证信息，没法和SendGrid SMTP服务建立认证连接。

操作步骤 #

• 先登录SendGrid后台，生成专门用于SMTP发信的API密钥：
  SendGrid的SMTP认证不使用账号登录密码，固定用户名为apikey，密码就是你生成的这串API Key，SMTP服务地址为smtp.sendgrid.net，优先用465端口走SSL连接。生成API Key时记得给它分配邮件发送的对应权限，不要用无权限的测试密钥。
• 回到Firebase控制台，进入你项目里已安装的Trigger Email扩展配置页，找到SMTP连接地址配置项，填写符合格式的连接串：

  smtps://apikey:你的SendGrid_SMTP_API密钥@smtp.sendgrid.net:465
  

  如果你的API Key里包含/、@、:这类特殊字符，要先对密钥部分做URL编码再填入，不然扩展解析连接串的时候会把特殊字符当成分隔符，导致凭证读取失败。
• 保存配置后等Firebase自动完成扩展的重新部署，等控制台显示扩展状态为「已部署」再做测试，不要刚保存就发测试邮件，这时候扩展还在更新，一样会报错。
• 测试时可以直接删掉之前报错的测试文档，重新在指定的邮件集合里新建一封测试邮件，几秒后查看文档里的delivery字段，状态变为SUCCESS就说明配置正常。

常见踩坑 #

• 不要把SMTP连接串里的用户名填成你的SendGrid登录邮箱，这个位置必须填固定值apikey，10个配错的人里有8个是栽在这。
• 如果填完还是报同类错误，直接去Firebase扩展的运行日志里查详细错误，常见原因包括API Key复制漏了字符、特殊字符没做URL编码、SendGrid侧还没完成发件人域名/单邮箱的身份验证。

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