电子邮件错误故障排除

本页列出了 Pushwoosh 在发送电子邮件时可能返回的错误代码，并按其原因进行了分组。每个条目都解释了错误的含义以及如何解决它。

账户和发送限制

这些错误意味着您的账户或配置集达到了发送上限、暂停或中止状态——消息本身没有任何问题。

错误	描述	如何处理
AccountDailyQuotaExceeded	您的账户已达到每日电子邮件发送配额。	等待配额重置，或联系 Pushwoosh 支持 请求更高的配额。
AccountSendingPaused / AccountSendingPausedException / ConfigurationSetSendingPaused / ConfigurationSetSendingPausedException	您的账户或配置集的电子邮件发送已暂停，通常是由于高退回率或投诉率。	查看您的退回和投诉率并联系 Pushwoosh 支持 以恢复发送。
AccountSuspended	您账户的电子邮件发送功能已被暂停。	联系 Pushwoosh 支持 了解原因以及如何恢复发送。
AccountThrottled	在短时间内发送了太多电子邮件，超过了发送速率限制。	降低您的发送速率，或联系 Pushwoosh 支持 请求更高的速率限制。

发件人和域名配置

这些错误表明您的发件人域名或“发件人”地址的设置和验证存在问题。

错误	描述	如何处理
CannotGetCredentials	Pushwoosh 无法获取发送电子邮件所需的凭据。	检查您的发件人域名是否已验证并处于活动状态。
FromEmailAddressNotVerifiedException	发件人地址未经验证，不能用于发送此电子邮件。	验证发件人的域名和电子邮件地址，然后重试。
FromEmailMissing	“发件人”电子邮件地址缺失或无效。	在电子邮件平台配置或消息设置中设置一个有效且已验证的“发件人”电子邮件地址。
FromNameMissing	电子邮件的“发件人姓名”缺失或无效。	在电子邮件平台配置或消息设置中设置一个有效的“发件人姓名”。
MailFromDomainNotVerified / MailFromDomainNotVerifiedException	由于 Pushwoosh 无法找到发件人域名所需的 MX 记录，因此无法发送该消息。	检查您发件人域名的 DNS/DKIM 记录并确保它们已正确发布。
InvalidTrackingOptionsException	为打开/点击跟踪配置的自定义跟踪域名无效。	检查您的自定义跟踪域名设置。

收件人地址问题

这些错误是由收件人电子邮件地址本身引起的——其格式、退回和投诉历史——而不是由您的账户或模板引起的。

错误	描述	如何处理
AddressContainsControlOrWhitespace	电子邮件地址包含控制字符或多余的空格。	从电子邮件地址中删除任何隐藏字符或空格，然后重试。
EmailComplaint	收件人之前曾将您的邮件标记为垃圾邮件。	将此收件人从未来的发送列表中移除，以保护您的发件人声誉。
EmailIsBounced	由于此电子邮件地址已经退回，因此未发送该消息。	使用一个有效、活跃的电子邮件地址，或将此收件人从您的邮件列表中移除。
IllegalEmailAddress	收件人的电子邮件地址格式无效。	检查收件人的电子邮件地址并更正它。
UnableToParseEmailBCC	BCC 字段包含无效值。	检查 BCC 字段中地址的格式。

SMTP 投递错误

这些错误发生在 Pushwoosh 通过 SMTP 投递消息时，原因从缺少配置到连接失败不等。

错误	描述	如何处理
SMTPCannotProcessData	Pushwoosh 无法为 SMTP 投递构建电子邮件。	检查电子邮件模板设置。
SMTPCannotProcessFrom	SMTP “FROM” 字段为空。	为消息设置一个有效的“发件人”电子邮件地址。
SMTPCannotProcessRcpt	SMTP “RCPT”（收件人）字段为空。	检查收件人的电子邮件地址是否设置正确。
SMTPCannotProcessSending	通过 SMTP 发送消息时发生内部错误。	稍后重试发送消息。如果错误仍然存在，请联系 Pushwoosh 支持。
SMTPIsNotConfigured	此账户尚未设置 SMTP。	联系 Pushwoosh 支持 以配置 SMTP 发送。
SMTPUnableToCreateConnection	Pushwoosh 无法建立 SMTP 连接。	检查您的 SMTP 服务器设置和凭据，然后重试。
SMTPUnableToSignDKIM	Pushwoosh 无法使用 DKIM 签署消息。	检查您发件人域名的 DKIM 配置。
SMTPUnknownError	发生未指定的 SMTP 错误。	重试发送消息。如果错误仍然存在，请联系 Pushwoosh 支持。

模板和内容错误

这些错误发生在 Pushwoosh 构建或渲染电子邮件时——模板丢失、占位符数据无效或 HTML 格式错误。

错误	描述	如何处理
CannotGetEmailPlaceholders	Pushwoosh 无法获取电子邮件模板中使用的占位符。	检查电子邮件模板中的动态内容占位符。
CannotGetTemplateBindings	Pushwoosh 无法获取渲染模板所需的数据绑定。	检查模板中使用的动态内容和 Liquid 模板设置。
CannotNormalizeHTML	无法准备要发送的电子邮件内容。	检查电子邮件模板的 HTML 内容是否有错误。
CannotProcessEmailTemplateFromRepo	无法加载和处理电子邮件模板。	检查电子邮件模板设置并重试。
EmailCannotGetEmailTemplateCode	未能获取 email_template_code 或其为空。	检查平台是否配置正确并重试。
EmailCannotGetEmailTemplateFromRepo	未能通过 email_template_code 获取电子邮件模板。	检查平台是否配置正确并重试。
InvalidRenderingParameterException	用于填充模板的值之一无效，通常是由于 JSON 格式错误。	检查传递给模板的动态内容数据。
InvalidTemplateException	无法渲染指定的电子邮件模板。	检查电子邮件模板是否有错误并重试。
MissingRenderingAttributeException	未提供模板中占位符引用的值。	确保模板中使用的所有占位符都有匹配的值。
TemplateDoesNotExistException	指定的电子邮件模板不存在。	检查电子邮件模板是否配置正确且未被删除。
TooDeepTemplateInsertion	模板嵌套过深。	减少电子邮件内容中嵌套模板插入的数量。
UnableToBuildEmailAttachments	无法构建一个或多个附件。	检查添加到电子邮件的附件并重试。
UnableToBuildHTML	编译电子邮件模板失败。很可能是模板中包含与动态内容占位符或 Liquid 模板相关的错误。	检查电子邮件模板设置。
UnableToCreateHTML	Pushwoosh 无法为电子邮件生成最终的 HTML。	检查电子邮件模板设置。
UnableToInsertTemplate	Pushwoosh 无法将引用的模板插入到电子邮件中。	检查电子邮件内容中插入/嵌套的模板引用。
UnableToMinifyHTML	Pushwoosh 无法压缩电子邮件的 HTML 内容。	检查电子邮件模板的 HTML 是否有格式错误的标记。

Liquid 模板和 Connected Content

这些错误特定于 Liquid 语法和用于提取个性化数据的 Connected Content 请求。

错误	描述	如何处理
ConnectedContentInvalidJSON	Connected Content 端点返回了无效的 JSON。	检查您的后端是否为 Connected Content 请求返回了有效的 JSON。
ConnectedContentInvalidParameters	传递给 Connected Content 的参数数量与模板不匹配。	根据您的模板检查在 Connected Content 标签中传递的参数。
ConnectedContentInvalidTemplate	Connected Content 标签包含无效的 Liquid 模板。	检查 Connected Content 标签内使用的 Liquid 语法。
ConnectedContentInvalidURL	Pushwoosh 无法获取 Connected Content 中指定的 URL。	检查 Connected Content URL 是否正确且可访问。
ConnectedContentInvalidVarExpression	Connected Content 中使用的 ${} 表达式无效。	检查 Connected Content 标签中使用的 ${} 语法。
InvalidLiquidTemplate	电子邮件包含无效的 Liquid 模板。	检查电子邮件中使用的 Liquid 模板 语法。
LiquidTemplateInvalidParsing	由于语法错误，无法解析 Liquid 模板。	检查电子邮件中使用的 Liquid 模板 语法。
LiquidTemplateInvalidRendering	无法使用可用数据渲染 Liquid 模板。	检查 Liquid 模板 中使用的变量是否与收件人的可用数据匹配。
LiquidTemplateInvalidTimezone	在 Liquid 模板中，日期过滤器使用了无效的时区。	检查您的 Liquid 模板 中日期过滤器使用的时区值。

投递和基础设施错误

这些错误来自电子邮件发送基础设施本身。大多数是暂时的或内部的，其中一些需要 Pushwoosh 支持进行调查。

错误	描述	如何处理
CannotConnect	Pushwoosh 无法连接到电子邮件发送网关。	稍后重试发送消息。如果错误仍然存在，请联系 Pushwoosh 支持。
CannotGetDeviceAPIURL	Pushwoosh 无法确定发送电子邮件所需的 API URL。	联系 Pushwoosh 支持。
CannotSend	无法发送电子邮件。	稍后重试发送消息。如果错误仍然存在，请联系 Pushwoosh 支持。
EmailSESInvalidParameterValue	传递给 Amazon 的参数之一不正确。	检查传递的参数并重试。
Failed	由于内部原因，无法发送消息。	重试发送消息。如果错误仍然存在，请联系 Pushwoosh 支持。
MessageRejected	Amazon 拒绝了该消息，因此未发送。	检查消息内容和收件人地址，然后重试。
RequestTimeout	对电子邮件发送服务的请求超时。	稍后重试发送消息。
SpamDetected	该消息被标记为垃圾邮件，因此未发送。	检查您的内容是否有类似垃圾邮件的特征，如果您认为这是一个错误，请联系 Pushwoosh 支持。
TransientFailure	发送消息时，Amazon 端发生临时故障。	稍后重试发送消息。
UnableToUnmarshalMetaData	Pushwoosh 无法处理附加到电子邮件的元数据。	请联系 Pushwoosh 支持 并提供消息 ID。
UnknownError	发生未指定的发送错误。	请联系 Pushwoosh 支持 并提供消息 ID 以进行调查。

Amazon SES 配置错误

这些错误来自 Pushwoosh 的内部 Amazon SES 发送基础设施，而不是由您的消息内容或账户设置引起的。

错误	描述	如何处理
Amazon SES 配置错误 ConfigurationSetAlreadyExistsException ConfigurationSetDoesNotExistException EventDestinationAlreadyExistsException EventDestinationDoesNotExistException InvalidCloudWatchDestinationException InvalidConfigurationSetException InvalidDeliveryOptionsException InvalidFirehoseDestinationException InvalidLambdaFunctionException InvalidPolicyException InvalidS3ConfigurationException InvalidSNSDestinationException InvalidSnsTopicException RuleDoesNotExistException RuleSetDoesNotExistException TrackingOptionsAlreadyExistsException TrackingOptionsDoesNotExistException CustomVerificationEmailInvalidContentException CustomVerificationEmailTemplateAlreadyExistsException CustomVerificationEmailTemplateDoesNotExistException LimitExceededException ProductionAccessNotGrantedException AlreadyExistsException CannotDeleteException InvalidSendingPoolName	Pushwoosh 的 Amazon SES 发送基础设施出现内部错误。这不是由您的消息内容或账户设置引起的。	请联系 Pushwoosh 支持，并提供确切的错误名称和消息发送时间。