**终止支持通知：** 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="campaigns-troubleshooting"></a>

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

## 活动未成功处理或针对某些端点
<a name="troubleshooting-campaign-endpoints"></a>

 **目标端点**：当为所选渠道运行活动时，将针对的端点总数。此总数不包括客户细分中的重复或非活跃端点。

**处理的端点**：活动运行成功针对的端点总数。

对于**动态客户细分**，端点计数可能会根据为受众定义的标准随时间而变化，因此每个渠道的端点数量只是估计值。您可以导出客户细分以获取任何给定时间的端点总数。
+ 基于配送渠道限制的节流
+ 如果您将活动安排为使用收件人的当地时间（设置isLocalTime 为 true）
+ 如果活动未配置足够的时间来处理所有端点
+ 下游传输问题或呈现问题
+ 永久失败

### 节流
<a name="troubleshooting-campaign-throttling"></a>
+ `CampaignSendMessageThrottled`在广告活动投放的时间段内查看该 Amazon CloudWatch 指标，以确认这是否是问题所在。有关更多信息，请参阅 [在 CloudWatch 中查看 Amazon Pinpoint 指标](monitoring-view-metrics.md)。
+ 当超过端点传输速率能力时，就会发生节流。有关更多信息，请参阅 Amazon Pinpoint [限额](https://docs.aws.amazon.com/pinpoint/latest/developerguide/quotas.html)。

### 使用收件人时区
<a name="troubleshooting-campaign-time"></a>

当活动计划使用收件人的本地时间（[isLocalTime](https://docs.aws.amazon.com//pinpoint/latest/apireference/apps-application-id-campaigns.html)设置为 true）进行活动时，所有端点在端点定义中都必须具有格式正确的`Demographic.Timezone`属性值，否则将无法成功定位该端点。这是因为该[isLocalTime](https://docs.aws.amazon.com//pinpoint/latest/apireference/apps-application-id-campaigns.html)选项根据每个收件人的当地时区来计算配送时间。

### 处理时间
<a name="troubleshooting-campaign-processing-time"></a>
+ 当活动没有足够的时间来处理所有目标端点时，不会处理端点，并且日志会显示 `campaign_send_status` 为 [https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-campaign.html#event-streams-data-campaign-attributes-attrs](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-campaign.html#event-streams-data-campaign-attributes-attrs)。
+ 根据您的活动所针对的端点数量，验证是否基于您的使用案例和传输渠道配置了**活动运行的最长时间**和**每秒的最大消息数**。有关更多信息，请参阅 [编辑项目的默认设置](projects-manage-edit.md)。

### 传输、呈现或永久失败
<a name="troubleshooting-campaign-other"></a>
+ 当访问不同的端点类型时，可能会出现传输问题。确认日志记录已开启，以帮助确定失败原因。要进一步排查下游传输问题，请参阅与相应端点类型相关的传输问题：[电子邮件渠道故障排除](channels-email-troubleshooting.md)、[短信渠道故障排除](channels-sms-troubleshooting.md)、[语音渠道故障排除](channels-voice-troubleshooting.md) 和 [推送渠道故障排除](channels-push-troubleshooting.md)。
+ 发生呈现问题的原因有：使用消息模板但缺少模板数据、模板数据格式不正确或模板参数与端点数据不匹配，等等。有关更多信息，请参阅传输问题下的电子邮件部分。
+ 当 Amazon Pinpoint 无法访问端点地址时，就会发生永久失败。永久错误的原因会显示在日志中。永久失败不会被重试。永久失败的示例包括无效地址（例如电子邮件地址或电话号码无效）、权限问题、账户处于沙盒中或限额不足，等等。