SendGrid发送的邮件始终处于pending状态如何排查解决

1. 账户配置核查 #

• 确认SendGrid账户已完成发件人身份验证，你使用的发件邮箱需完成单一发件人验证或域名验证，未验证的发件地址提交的所有邮件都会被拦截进入pending队列，不会触发实际投递
• 检查账户状态是否正常：查看后台是否有未处理的风控告警、发送额度是否已耗尽，新注册的SendGrid账户未完成完整资质校验时会有严格的初始发送限制，未达标前所有邮件都会被临时挂起
• 核对所用API Key的权限：创建API Key时必须勾选Mail Send权限，权限不足会导致提交的邮件请求无法进入投递流程

2. 项目与请求核查 #

• 核对ASP.NET Core项目的配置参数：检查appsettings.json中填写的SendGrid API Key、发件人邮箱是否和SendGrid后台配置的信息完全一致，拼写错误、大小写不匹配都会导致邮件无法正常投递
• 确认运行环境网络连通性：项目运行环境需要可以正常访问SendGrid的API接口，网络限制导致请求无法送达SendGrid服务端时，也会出现邮件一直处于pending状态的情况
• 排查邮件内容合规性：测试邮件不要重复发送完全相同的内容，不要包含违规敏感内容，被风控识别为垃圾邮件的内容会被直接挂起
• 捕捉接口返回值排查错误：在调用SendGrid发送邮件的代码位置添加日志，输出接口返回的状态码和信息，SendGrid会明确返回请求错误的具体原因，比如403对应权限问题、400对应参数错误

3. 投递规则核查 #

• 确认发件域名已配置正确的SPF、DKIM、DMARC DNS记录，缺少三类记录的发件域名发送的邮件大概率会被目标邮箱服务商拦截，SendGrid检测到投递风险过高时也会主动挂起排队邮件
• 不要向不存在的邮箱地址、有过投诉/退信记录的邮箱地址发送测试邮件，触发退信、投诉后SendGrid会临时限制发送权限，已有排队邮件也会进入pending状态

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