Gmail API发送含undisclosed-recipients的To头邮件被拒绝如何解决

问题原因 #

To: undisclosed-recipients:;确实是符合RFC822规范的合法格式，多用于所有收件人均放在Cc/Bcc字段、无需展示公开收件人的场景，但Gmail API的输入校验逻辑未兼容该特殊格式，因此触发400非法参数报错。

解决方案 #

• 方案1：将To头替换为发件人自身地址
  直接把MIME报文中的To字段设置为和From一致的发件人邮箱，所有真实收件人全部放在Cc或Bcc字段中。该方案改动最小，收件人收到邮件后仅能看到To字段为发件人地址，不会暴露其他收件人信息，和使用undisclosed-recipients的实际效果完全一致。
• 方案2：通过Gmail API请求参数指定收件人
  调用Gmail API发送邮件时，直接在请求的personalizations参数中明确指定所有收件人（含To/Cc/Bcc），无需依赖MIME报文内的To头，API会优先取请求参数中的收件人列表发送，不会校验MIME报文中的To字段内容是否合规。
• 方案3：调整PHPMailer配置避免生成该格式
  生成MIME报文前，在PHPMailer中显式调用$mail->AddAddress('你的发件人邮箱地址');，PHPMailer就不会自动生成undisclosed-recipients:;的To头，输出的MIME报文可直接通过Gmail API的校验。

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