使用SendGrid发信时Gmail仅显示用户名而非姓名如何解决

解决方案 #

• 检查发件人格式配置：SendGrid的SMTP/API请求中，发件人字段必须严格按照"FirstName LastName" <hello@example.com>格式填写，姓名部分如果包含特殊字符必须加英文双引号，无特殊字符也建议添加避免邮件客户端解析异常。
• 校验域名配置一致性：确认SendGrid后台认证的域名与发件邮箱后缀完全匹配，即使开启了自动安全模式，也需要手动核对DKIM、SPF记录的解析值与SendGrid给出的配置完全一致，避免代发身份校验不通过导致Gmail隐藏发件人全名。
• 排查Google Workspace配置：在Google Workspace后台的邮件白名单中添加SendGrid的发送域，避免谷歌将SendGrid代发的邮件标记为低可信度邮件，低可信度邮件的发件人姓名会被自动替换为邮箱前缀。
• 清除Gmail缓存测试：如果之前用相同发件地址发送过无姓名格式的测试邮件，Gmail会本地缓存发件人显示规则，可使用未收到过该地址邮件的全新Gmail账号测试，或删除当前Gmail账号中该发件人的联系人记录后重新测试。
• 关闭SendGrid发件人重写功能：如果开启了退信追踪相关的发件人地址重写功能，SendGrid会修改邮件头的From字段内容，导致Gmail无法正确解析姓名，可在SendGrid后台关闭该功能，改用自定义退信路径替代即可。
• 校验邮件头原始内容：发送测试邮件后在Gmail中查看原始邮件，确认From头字段的内容与预期的姓名+邮箱格式一致，如果原始字段已异常则排查SendGrid侧的配置，如果原始字段正常但显示异常，可等待24-48小时让域名发件信誉更新后再重试，新认证的域名通常会有短暂的显示异常期。

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