Firestore Trigger Email扩展无法从文档读取'from'发件人地址问题

云上老周

2026-6-30

Firestore Trigger Email 扩展无法自定义发件人地址的解决办法

核心原因和解决方案：

Gmail SMTP的硬性限制：Gmail个人账号的SMTP服务会强制将发件人替换为你登录的主邮箱，不管你在Firestore文档里设置什么from字段，这是Gmail的安全机制，防止地址冒用。
检查扩展的自定义发件人开关：看你的配置截图，确认是否开启了Allow custom FROM addresses选项。如果没开，扩展会直接用SMTP配置的邮箱覆盖你设置的from字段，必须打开这个开关才能启用自定义发件人。
验证自定义发件人为Gmail别名：就算开了开关，Gmail只允许使用你账号下已验证的别名作为自定义发件人。你需要先在Gmail设置里添加并验证目标邮箱地址，把它设为账号别名，这样SMTP才会认可这个发件人。
确认Firestore字段格式正确：确保Firestore文档里的from字段格式合规，要么是纯邮箱字符串（比如"user@example.com"），要么是包含名称和地址的对象：
```
{
  "name": "用户名称",
  "address": "user@example.com"
}
```
格式错误的话，扩展会忽略这个字段，自动 fallback到SMTP配置的邮箱。