Gmail 邮件标头限制

本文介绍了 Gmail 对电子邮件标头施加的限制,并提供了建议的操作,以帮助您将标头保持在这些限制范围内。将邮件标头保持在限制范围内有助于确保邮件正确递送。

电子邮件标头会提供邮件的相关信息(即元数据)。例如,电子邮件标头包含有关发件人、收件人和邮件发送时间的信息。

为保护您组织中的用户免受恶意邮件、垃圾邮件或钓鱼邮件的侵害,Gmail 会屏蔽标头超出此处所述的限制的邮件。垃圾邮件发件人和其他恶意发件人可能会在邮件中使用大标头来冒充合法发件人或绕过垃圾邮件规则。

有时,合法且非恶意邮件会包含非常大的标头。这种情况通常发生在发送自动电子邮件的设备或系统上。导致邮件标头过大的其他一些原因包括自定义标头和大型的“Subject:”标头。例如,向“Subject:”标头添加邮件内容可能会导致“Subject:”标头超出单个标头允许的限制。

标头限制错误

Gmail 屏蔽标头超出限制的邮件时,会向发件人返回 SMTP 错误消息。该消息会说明超出限制的具体内容。请参阅下文的排查邮件标头错误部分,查看错误消息示例以及建议针对各条错误消息采取的措施。

如需查看所有 Gmail SMTP 错误消息,请参阅 Gmail SMTP 错误和代码

Gmail 邮件标头限制

为确保邮件正确递送,请将邮件标头保持在这些限制范围内。这些限制也适用于收到的邮件。

说明 最大值
单封邮件中的所有标头 500KB
每封邮件的标头数量 5000
任何单个标头

32KB(英文冒号后的值)

此限制不适用于以下标头类型:“Cc:”“To:”“References:”。不过,这些标头类型会计入单封邮件中所有标头的总大小。

“Message-ID:”标头 500 个字符(英文冒号后的字符)
“Subject:”标头 998 个字符(英文冒号后的字符)

标头名称

1KB(英文冒号前面)

超出此限制的标头类型通常是带有“X”前缀的自定义标头,例如“X-My-Custom-Header:”。

英文冒号后允许的最大值为 32KB。

排查邮件标头错误

如果外发邮件因邮件标头超出 Gmail 的邮件标头限制而被拒绝,我们建议您采取以下措施:

  • 截断标头值
  • 将标头信息移至邮件正文

以下错误消息中显示的值是示例值,在您收到的错误消息中会有所不同。

错误消息 说明和建议采取的措施
552-5.3.4 Your message exceeded Google's message header size limits. 邮件的总标头字节数不得超过 512000 个,标头字段数不得超过 5000 个。请访问 https://support.google.com/a?p=header-limits 查看我们的大小指南。

邮件中的标头超过了每封邮件的标头数量单封邮件中所有标头的总大小所允许的最大值。

如需解决此问题,请将一些信息从邮件标头移至邮件正文。

552-5.3.4 The size of the standard-header-type header value (32769 bytes) exceeds Google's limit of 32768 bytes per individual header size. 请访问 https://support.google.com/a?p=header-limits 查看我们的大小指南。

标准标头超过任何单个标头所允许的 最大值 (32KB)。错误消息会指明哪个标头过长。

如需解决此问题,请在创建新邮件时截断此标头。如果您无法轻松截断此标头,请将一些信息从标头移至邮件正文。

552-5.3.4 The size of one of the headers value (32769 bytes) exceeds Google's limit of 32768 bytes per individual header size. 请访问 https://support.google.com/a?p=header-limits 查看我们的大小指南。

非标准标头超过任何单个标头所允许的 最大值 (32KB)。为保护可能包含敏感信息的内容,我们不会在错误消息中添加自定义标头名称。

如需解决此问题,请找出导致错误的标头,并在创建新邮件时截断该标头。

552-5.3.4 The size of a header name (1001 bytes) exceeds Google's header name limit of 1000 bytes. 请访问 https://support.google.com/a?p=header-limits 查看我们的大小指南。

邮件包含的标头名称超出了标头名称(英文冒号前面)所允许的 最大值

超出此限制的标头类型通常是自定义标头。因此,如需解决此问题,请更新自定义标头,使其不超过允许的最大值。