如何配置Amazon SES SMTP对接Firebase Trigger Email扩展

前置参数准备 #

要生成符合扩展要求的SMTP URI，需先从Amazon SES侧集齐三类必要信息：

• 对应部署区域的SMTP主机地址：你已获取的email-smtp.us-east-2.amazonaws.com即为有效值，无需额外添加http/https前缀
• SES专属SMTP认证凭证：禁止直接使用AWS根账号密码、通用IAM密钥作为认证信息，需在SES控制台的SMTP设置板块创建专属发信凭证对，生成的Access Key ID作为URI中的用户名，对应的Secret Access Key作为URI中的密码，该凭证仅在生成时完整展示一次，需提前妥善留存
• 协议匹配端口：smtps为隐式TLS加密协议，固定对应465端口，需显式标注在URI配置中避免连接异常

SMTP URI 标准拼接规则 #

严格匹配扩展要求的格式即可完成配置，标准模板为：

smtps://<SES SMTP用户名>:<SES SMTP密码>@<SES SMTP主机名>:465

结合你使用的us-east-2区域主机，可参考以下实际拼接示例：

若你的SES SMTP用户名为AKIAIOSFODNN7EXAMPLE，密码为wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY，最终可直接填入扩展配置的URI为：
smtps://AKIAIOSFODNN7EXAMPLE:wJalrXUtnFEMI%2FK7MDENG%2FbPxRfiCYEXAMPLEKEY@email-smtp.us-east-2.amazonaws.com:465
注意：如果生成的SMTP密码包含/、@、:等特殊字符，必须先对特殊字符做URL编码再嵌入URI，否则会因分隔符误判导致解析失败、鉴权报错

常见对接问题排查 #

• 区域一致性校验：SES的SMTP主机、发信凭证、发信权限必须与所选AWS区域完全匹配，跨区域拼接会直接触发连接失败
• 沙箱模式限制：若你的SES账号仍处于沙箱测试阶段，需提前将所有目标收件人添加到SES的验证地址白名单中，否则即使SMTP配置正确也会被拦截
• 端口合规性校验：不要替换为25端口（多数云厂商、运营商会默认屏蔽该端口）或者587端口（对应STARTTLS协议，与smtps隐式TLS的协议规则不兼容），否则会出现连接超时
• 特殊字符编码校验：SMTP URI的结构解析是将:和@作为层级分隔符的，若密码中的特殊字符未编码，会被误判为结构分隔符，导致用户名、密码被截断

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