使用Microsoft GraphClient发送邮件始终进入垃圾文件夹求助

当使用Microsoft Graph API发送邮件进入垃圾箱，但同一账号网页版发送相同内容正常时，通常是因为API发送的邮件在认证信息、邮件元数据、内容风险这几方面和网页版存在差异，以下是具体的排查和解决步骤：

1. 显式配置发件人相关字段 #

网页版Outlook会自动填充From、Reply-To等字段，而API发送时如果未显式设置，可能会使用租户默认的发送地址，导致邮件认证不匹配，触发垃圾过滤。在代码中添加以下配置：

// 设置发件人（和登录账号一致）
val fromEmail = EmailAddress()
fromEmail.address = username
val fromRecipient = Recipient()
fromRecipient.emailAddress = fromEmail
message.from = fromRecipient

// 设置回复地址
val replyToEmail = EmailAddress()
replyToEmail.address = username
val replyToRecipient = Recipient()
replyToRecipient.emailAddress = replyToEmail
message.replyTo = listOf(replyToRecipient)

2. 移除高风险内容（关键！） #

你的代码中邮件内容包含明文密码（pwd变量），这类敏感信息是垃圾邮件过滤系统的高触发点。网页版发送时因为是用户手动操作，系统会给予更高信任度，但API自动发送的此类邮件会被判定为风险邮件。

建议：

• 替换明文密码为密码重置链接，让用户自行设置密码
• 避免在邮件中直接发送敏感凭证

3. 添加模拟Outlook的邮件头 #

网页版发送的邮件会带有特定的邮件头标识，API发送时可以添加这些头来降低垃圾评分：

// 添加邮件头模拟Outlook客户端发送
val headers = mutableListOf<InternetMessageHeader>()
// X-Mailer头
val mailerHeader = InternetMessageHeader()
mailerHeader.name = "X-Mailer"
mailerHeader.value = "Microsoft Outlook 16.0"
headers.add(mailerHeader)
// 可从网页版邮件原始内容中复制其他必要头信息补充
message.internetMessageHeaders = headers

4. 对比邮件原始内容找差异 #

获取网页版和API发送邮件的原始内容（包括所有头信息），对比两者的差异：

• 网页版：打开邮件 → 点击"更多操作" → "查看邮件原始内容"
• API：通过Graph API的messages接口获取已发送邮件的internetMessageHeaders和body.content

重点检查From、Sender、X-Mailer、DKIM-Signature、SPF相关头，确保API发送的邮件和网页版一致。

5. 检查域名认证配置 #

确保发件人域名已经配置了正确的DKIM、SPF、DMARC记录，这些是邮件通过收件方垃圾过滤系统的核心认证机制：

• SPF：授权微软Exchange作为域名的发送服务器
• DKIM：配置微软提供的DKIM密钥，确保邮件内容未被篡改
• DMARC：设置域名的邮件认证策略，指导收件方处理未通过认证的邮件

6. 排查账号/应用发送信誉 #

如果以上配置都正确，可能是API使用的账号或应用被微软反垃圾系统标记为低信誉：

• 检查Exchange管理中心的反垃圾邮件规则，确认账号未被列入限制列表
• 若为批量发送场景，申请提升应用的发送配额和信誉等级

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