Rails集成SendGrid后生产环境发信全部进入垃圾箱该如何排查？

1. SendGrid 账户与基础配置排查 #

• 确认SendGrid账户已完成完整身份验证，未处于限制/待审核状态，无平台违规警告
• 确认已在SendGrid中完成对应发件域名的单域名验证，不要使用SendGrid提供的共享发件域名
• 检查发件IP信誉分：如果使用SendGrid共享IP，确认当前IP未被反垃圾组织列入黑名单；如果是专用IP，确认已完成IP预热流程，无短时间内大量发送低互动邮件的记录
• 确认账户发信类型和实际发送内容匹配，没有违规发送未备案的营销类、通知类邮件

2. DNS 解析配置验证 #

• 确认发件域名的SPF记录已正确配置，包含SendGrid授权段，参考配置为v=spf1 include:sendgrid.net ~all，无多条SPF记录冲突问题
• 确认DKIM记录已按照SendGrid后台给出的公钥值正确配置，解析状态正常，无域名大小写、selector配置错误
• 确认DMARC记录已配置，初始可设置为v=DMARC1; p=none; rua=mailto:dmarc@你的域名.com收集校验日志，不要直接设置p=reject导致正常邮件被拦截
• 如果配置了自定义反向解析（PTR记录），确认PTR记录和发件域名匹配

3. 邮件内容与Header排查 #

• 检查邮件主题和正文是否包含垃圾邮件高频触发词，避免全大写、大量感叹号、特殊符号的使用
• 确认邮件正文同时包含HTML和纯文本版本，不要只有纯HTML内容且大量嵌入图片、链接占比过高
• 检查邮件Header是否配置了正确的Reply-To地址，和发件域名属于同一根域，不要为空或者和发件域完全无关
• 发件人名称尽量使用企业/产品官方名称，不要使用模糊的昵称、营销类敏感名称
• 不要在邮件内放入大量未经过用户确认的外部链接，所有链接的域名尽量和发件域名保持一致
• 确认所有商业邮件底部都添加了清晰可点击的取消订阅入口，符合SendGrid发件规则和反垃圾法规要求

4. Rails 侧配置校验 #

• 确认config/environments/production.rb中Action Mailer配置正确：

config.action_mailer.delivery_method = :sendgrid_actionmailer
config.action_mailer.sendgrid_actionmailer_settings = {
  api_key: ENV['SENDGRID_API_KEY'],
  raise_delivery_errors: true
}

• 确认没有在业务代码中硬写临时from地址覆盖全局默认配置，所有业务邮件的发件地址都属于已验证的发件域名范围
• 开启SendGrid的事件通知，配置webhook接收发送后的反馈，包括是否被对方服务器拒收、是否被标记为垃圾邮件的回调数据

调试思路 #

• 先使用SendGrid后台自带的测试发信功能，发测试邮件到个人测试邮箱，查看是否入垃圾箱，排除Rails侧配置问题
• 使用带垃圾邮件评分功能的测试工具发送测试邮件，获取垃圾邮件评分，针对扣分点逐一修正
• 提取已发送邮件的完整Header，查看反垃圾标记的具体原因，比如是否为SPF校验失败、DKIM签名无效、IP信誉分低等明确标注的问题
• 小批量发送给真实活跃用户，引导用户将发件地址加入通讯录，逐步提升发件域的信誉分

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