使用SendGrid发送批量邮件时遇BadRequest错误求助

1. 主题缺失错误的原因与修复 #

你遇到的「主题缺失」错误，是因为SendGrid的API规则：当显式设置Personalizations集合时，根级别的Subject（通过SetSubject设置）会被忽略。必须满足以下两个条件之一：

• 每个Personalization对象都单独设置主题；
• 使用SendGrid官方提供的邮件模板（而非自行通过AddContent加载的HTML内容），且模板中定义了主题。

修复代码 #

在循环创建Personalization的过程中，为每个实例添加主题，并同步全局替换项：

foreach (var a in attendees)
{
    var per = new Personalization();
    per.Tos = new List<EmailAddress>(new[] { new EmailAddress(a.Email, a.FullName) });
    // 为当前个性化设置添加主题
    per.Subject = asset.Subject;
    per.Substitutions = new Dictionary<string, string>();
    per.Substitutions.Add("[fullname]", a.FullName);
    per.Substitutions.Add("[email]", a.Email);
    // 同步全局替换项到当前个性化设置
    foreach (var sub in msg.Substitutions)
    {
        if (!per.Substitutions.ContainsKey(sub.Key))
        {
            per.Substitutions.Add(sub.Key, sub.Value);
        }
    }
    personalizations.Add(per);
}

2. 授权错误的补充说明 #

你通过白名单域名解决了该问题，这里再补充两个注意点：

• 确保SendGrid API Key权限完整（需包含邮件发送权限）且未过期；
• 发件人域名必须完成SPF、DKIM配置，否则会触发发送权限验证失败。

3. Substitutions与Personalizations是否互斥？ #

两者不互斥，但使用逻辑有区别：

• 根级的AddSubstitution是全局替换，默认会应用到所有未显式设置Substitutions的Personalization；但当手动给Personalization赋值Substitutions集合时，全局替换不会自动合并，需要手动同步；
• 每个Personalization的Substitutions是个性化替换，优先级高于全局替换：如果某个替换键在两者中都存在，会使用Personalization中的值。

额外注意事项 #

• 当使用Personalizations时，根级的AddTo、AddCc等收件人设置会被忽略，所有收件人必须通过Personalization.Tos、Personalization.Ccs添加；
• 避免重复设置相同的替换键，否则可能导致预期外的替换结果。

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