**终止支持通知：** AWS 将于 2026 年 10 月 30 日终止对亚马逊 Pinpoint 的支持。2026 年 10 月 30 日之后，您将不再能够访问 Amazon Pinpoint 控制台或 Amazon Pinpoint 资源（端点、分段、活动、旅程和分析）。有关更多信息，请参阅 [Amazon Pinpoint 终止支持](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：** APIs 与短信相关、语音、移动推送、OTP 和电话号码验证不受此更改的影响，并受 AWS 最终用户消息的支持。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 电子邮件渠道故障排除
<a name="channels-email-troubleshooting"></a>

确认日志记录开启，以帮助您确定失败原因。有关日志记录的更多信息，请参阅[监控和日志记录](troubleshooting.md#troubleshooting-logging)以及[电子邮件事件](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-email.html)。

## 呈现问题
<a name="troubleshooting-email-message-not-displayed"></a>
+ 使用电子邮件模板时，当消息变量缺失、格式不正确或者消息变量与端点数据不匹配时，就会出现呈现失败，从而导致电子邮件发送失败。
+ 要识别呈现失败，请查看活动运行的时间范围内的 Amazon SES CloudWatch 指标 `RenderingFailure`。呈现失败在 Amazon Pinpoint 事件日志中显示为 [\$1email.rendering\$1failure events](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-email.html#event-streams-data-email-attributes)。
+ 要解决此问题，请确认所有消息变量都存在相应的端点属性并且格式正确。有关更多信息，请参阅 [向消息模板添加个性化内容](message-templates-personalizing.md)。
+ 为模板中的所有消息变量配置默认值，以避免当某个端点缺少属性时呈现失败。
+ 在没有模板的情况下试着运行活动，以确认端点能否成功收到消息。此操作可以帮助确认问题是否与模板变量有关。

## 退回状态
<a name="troubleshooting-email-message-bounce"></a>

****软退回的解决方案****
+ *软退回* 因临时故障引起，显示在日志的 **\$1email.softbounce** 事件类型下。Amazon Pinpoint 处理软退回的方式是在特定的时间段内尝试重新发送软退回的电子邮件。
+ 在以下情况下会发生软退回：
  + 收件人邮箱已满。
  + 收件人邮箱暂时不可用。
  + 超出服务器限制。
  + 服务器超载。
+ 与软退回相关的特定错误代码有 421、450、451 或 452。有关这些错误代码的描述，请参阅[简单邮件传输协议 (SMTP) 增强状态代码注册表](https://www.iana.org/assignments/smtp-enhanced-status-codes/smtp-enhanced-status-codes.xhtml)。日志中的 **smtp\$1response** 提供了退回事件的错误代码。

****硬退回的解决方案****
+ *硬退回* 是一种持续的传输失败，显示在日志的 **\$1email.hardbounce** 事件类型下。不会重试这些失败。
+ 在以下情况下会发生硬退回：
  + 电子邮件地址不存在。
  + 域名不存在。
  + 收件人的电子邮件服务器拦截了这些邮件。
  + 电子邮件地址在账户抑制列表上。
+ 监控您的项目中的硬退回数量，并从收件人列表中删除硬退回的电子邮件地址。硬退回会对您的发送信誉和电子邮件的送达率产生负面影响。有关更多信息，请参阅关于[退回](channels-email-best-practices.md#channels-email-best-practices-bounce-rate)的最佳实践。