电子邮件错误故障排除

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

账户和发送限制

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

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

发件人和域名配置

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

错误	描述	怎么办
CannotGetCredentials	Pushwoosh 无法获取发送电子邮件所需的凭据。	检查您的 发件人域名 是否已验证并处于活动状态。
FromEmailAddressNotVerifiedException	发件人地址未经验证，不能用于发送此电子邮件。	验证发件人的域名和电子邮件地址 然后重试。
From email domain is not verified (1296)	“发件人”域名尚未完成 DNS 验证，因此无法创建消息（包括测试邮件）。	在 您的发件人域名 中检查域名状态，并添加任何仍标记为 待处理 的记录。
Reply email domain is not verified (1297)	“回复”域名尚未完成 DNS 验证，因此无法创建消息（包括测试邮件）。	在 您的发件人域名 中检查域名状态，并添加任何仍标记为 待处理 的记录。
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 发送。
SMTPProviderBlocked (1138)	在短时间内出现过多退回和错误后，Pushwoosh 已暂停从您的账户向该收件人的电子邮件提供商发送邮件。	等待发送恢复，如果问题持续存在，请联系 Pushwoosh 客服。
SMTPUnableToCreateConnection	Pushwoosh 无法建立 SMTP 连接。	检查您的 SMTP 服务器设置和凭据，然后重试。
SMTPUnableToSignDKIM	Pushwoosh 无法使用 DKIM 签署消息。	检查您发件人域名的 DKIM 配置。
SMTPUnknownError	发生未指定的 SMTP 错误。	重试发送消息。如果错误仍然存在，请联系 Pushwoosh 客服。
SMTPUnknownProvider (1139)	Pushwoosh 无法确定收件人地址的电子邮件提供商。	检查收件人的电子邮件地址格式是否正确，如果地址看起来正确，请联系 Pushwoosh 客服。

模板和内容错误

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

错误	描述	怎么办
CannotGetEmailPlaceholders	Pushwoosh 无法获取电子邮件模板中使用的占位符。	检查电子邮件模板中的 Dynamic Content 占位符。
CannotGetTemplateBindings	Pushwoosh 无法获取渲染模板所需的数据绑定。	检查模板中使用的 Dynamic Content 和 Liquid 模板 设置。
CannotNormalizeHTML	无法准备要发送的电子邮件内容。	检查电子邮件模板的 HTML 内容是否有错误。
CannotProcessEmailTemplateFromRepo	无法加载和处理电子邮件模板。	检查电子邮件模板设置，然后重试。
EmailCannotGetEmailTemplateCode	未能获取 email_template_code 或其为空。	检查平台是否配置正确，然后重试。
EmailCannotGetEmailTemplateFromRepo	未能通过 email_template_code 获取电子邮件模板。	检查平台是否配置正确，然后重试。
InvalidRenderingParameterException	用于填充模板的值之一无效，通常是由于 JSON 格式错误。	检查传递给模板的 Dynamic Content 数据。
InvalidTemplateException	无法渲染指定的电子邮件模板。	检查电子邮件模板是否有错误，然后重试。
MissingRenderingAttributeException	未提供模板中占位符引用的值。	确保模板中使用的所有占位符都有匹配的值。
TemplateDoesNotExistException	指定的电子邮件模板不存在。	检查电子邮件模板是否配置正确且未被删除。
TooDeepTemplateInsertion	模板嵌套过深。	减少电子邮件内容中嵌套模板插入的数量。
UnableToBuildEmailAttachments	无法构建一个或多个附件。	检查添加到电子邮件的附件，然后重试。
UnableToBuildHTML	编译电子邮件模板失败。很可能是模板中包含与 Dynamic Content 占位符 或 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 客服，并提供确切的错误名称和消息发送时间。