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

确认日志记录开启，以帮助您确定失败原因。有关更多信息，请参阅[监控和日志记录](troubleshooting.md#troubleshooting-logging)。对于不是通过活动或旅程发送的事务性推送通知，请记录 [API 响应](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams.html)以了解[传输状态](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#apps-application-id-messages-model-messageresult)。

## 监控传输问题
<a name="troubleshooting-push-delivery"></a>
+ 对于通过 SendMessages API 发送的直接推送通知消息，请验证您是否捕获了 API 响应以获取有关交付的见解。为此，请在响应中查看[EndpointResult](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#apps-application-id-messages-model-messageresponse)对象内部的 StatusMessage 属性。此属性包含从下游推送通知服务收到的[平台响应代码](https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html#platform-returncodes)。
+ 对于活动，请确认通过 Kinesis Data Streams 进行日志记录已开启。查看 [\$1campaign.send](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-campaign.html#event-streams-data-campaign-attributes) 事件中的[平台响应代码](https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html#platform-returncodes)，了解 Amazon Pinpoint 从下游推送通知服务收到的传输结果。

## 未收到消息
<a name="troubleshooting-push-message-not-received"></a>

****问题和解决方案****
+ 设备连接问题 - 如果问题仅发生在某些设备上，请确认这些设备是否被阻止连接到推送通知服务端点。请参阅 [FCM 端口和您的防火墙](https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall)，以及[您的 Apple 设备是否收不到 Apple 推送通知](https://support.apple.com/en-us/102266)。
+ 端点**OptOut**属性值-如果终端节点**OptOut**值设置为`ALL`，则终端节点将不会收到通知。使用 [get-endpoint CLI](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/get-endpoint.html) 确认终端节点**OptOut**值已设置为。`NONE`如果端点为选择退出，则通过活动或旅程发送的消息将不会传送到该端点，因此也不会生成任何日志。
+ 令牌环境 - 验证您的 Amazon Pinpoint 端点的渠道类型是否匹配为设备生成的令牌。例如，将 GCM 用作集成 FCM 的应用程序令牌地址的渠道，在沙盒中使用 apns\$1Sandbox 作为应用程序的渠道 APNs，或者在生产环境中使用 APNS 作为应用程序的渠道。

  要深入了解处于失败状态的传输尝试，请参阅传输尝试中使用的[相应推送渠道的推送通知响应代码](https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html#platform-returncodes)。

## 未显示消息
<a name="troubleshooting-push-message-not-displayed"></a>
+ 如果日志显示“成功传输”，但系统通知托盘上未显示消息，则此问题表明通知已传送到设备，但未在客户端应用程序中恰当处理。
+ 您可能会看到 Kinesis 事件日志显示**成功传输**状态，或者某个问题只发生在特定请求有效载荷或消息类型上。此问题可能表明通知已发送到设备，但未在系统通知托盘上显示。

  对于特定的请求负载或消息类型（例如，FCM 的数据为 Silent APNs），可能会发生这种情况。例如，如果消息是作为警报/通知有效负载接收的，而不是作为 data/silent 有效负载接收的，请检查当您的应用程序收到某种类型的数据、通知、警报或背景消息时，预期的操作是什么，以及应用程序是否可以处理不同的消息类型。
+ 要排查问题，请将日志语句包含在应用程序的消息处理程序中。有关示例，请参阅 [FCM](https://firebase.google.com/docs/cloud-messaging/android/receive) 和。[APNs](https://developer.apple.com/documentation/uikit/uiapplicationdelegate/1623013-application)这可帮助确定设备是否已收到通知，但未在系统通知托盘中显示。