基于Google Workspace的Identity 2.0邮件发送故障排查求助

一、代码层面的致命错误 #

你的SendAsync方法中存在SMTP服务器地址配置错误：

// 错误配置：用了发件邮箱地址而非Gmail官方SMTP服务器
await client.ConnectAsync("sendemail@institution.com", 587, MailKit.Security.SecureSocketOptions.Auto);

Gmail的SMTP服务器地址是固定的smtp.gmail.com，这个错误会导致生产环境无法正常连接邮件服务器，而开发环境可能因测试配置（如本地邮件服务）侥幸正常运行。修正后的代码：

private async Task SendAsync(MimeMessage messageBody)
{
    using (var client = new SmtpClient())
    {
        try
        {
            // 修正为Gmail官方SMTP服务器
            await client.ConnectAsync("smtp.gmail.com", 587, MailKit.Security.SecureSocketOptions.Auto);
            await client.AuthenticateAsync("sendemail@institution.com", "password");
            await client.SendAsync(messageBody);
            await client.DisconnectAsync(true);
        }
        catch (Exception ex)
        {
            // 添加异常日志记录，解决无排查记录的问题
            // 示例：Logger.LogError(ex, "邮件发送失败，收件人：{To}", messageBody.To);
            throw;
        }
    }
}

二、Gmail/Google Workspace侧的拦截原因 #

1. 敏感内容触发反垃圾规则

   • 带callbackCode的链接/码属于重置密码、邮箱确认这类高风险操作内容，Gmail反垃圾系统会严格检测，批量发送时更容易触发拦截。改成纯文本复制后找回密码邮件正常，但邮箱确认邮件可能因内容结构、生产环境收件人是陌生用户（开发环境为内部测试邮箱）再次触发规则。
   • 若机构域名未配置SPF/DKIM/DMARC记录，Gmail会直接静默丢弃邮件（无退回通知），而开发环境内部邮箱可能在白名单中不受影响。

2. 低安全性应用权限的限制
   Google Workspace对低安全性应用的权限有额外限制，生产环境的批量发送行为会被判定为异常操作，直接阻止发送且不返回通知。

3. 发送信誉与频率限制
   生产环境短时间内发送大量邮件、或收件人多次标记邮件为垃圾，会导致发件邮箱信誉下降，Gmail直接静默丢弃邮件；开发环境发送量小、收件人都是内部用户，不会触发这类限制。

三、具体排查方向 #

1. 修复SMTP配置后先做基础测试
   修正服务器地址后，在生产环境测试发送给内部白名单邮箱，确认邮件能否正常接收，排除代码层面的核心问题。

2. 替换低安全性应用权限为应用专用密码
   关闭低安全性应用权限，给发件邮箱开启双因素认证后生成应用专用密码，替代原密码用于SMTP认证，这能规避Google对低安全性应用的限制。

3. 配置域名的SPF/DKIM/DMARC记录

• SPF记录：添加包含include:_spf.google.com的规则，授权Gmail代表你的域名发送邮件
• DKIM：在Google Workspace后台开启DKIM签名，配置对应DNS记录
• DMARC：设置v=DMARC1; p=quarantine; sp=quarantine; rua=mailto:dmarc@yourdomain.com这类规则，提升邮件可信度

4. 优化邮件内容与发送行为

• 对比开发/生产环境的邮件内容，避免使用触发垃圾规则的关键词（如“立即点击”“验证链接”等），给callbackCode添加说明性文本（如“请复制以下验证码完成邮箱确认：”）
• 控制生产环境的发送频率，避免短时间内批量发送给大量陌生用户

5. 检查邮箱日志与过滤规则

• 登录发件邮箱，查看“已发送”“垃圾邮件”“已删除”文件夹，确认是否有被系统自动移动的邮件
• 在Google Workspace管理后台查看发件邮箱的发送配额、异常操作记录

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