How do I troubleshoot APNs mobile push notification failures in Amazon SNS?

Resolution

Configure and view push notification delivery status attributes for Amazon CloudWatch Logs

Follow the instructions in How do I access Amazon SNS topic delivery logs for push notifications?

Identify and troubleshoot push notification error response status codes

Review your delivery status logs for failed push notification deliveries ("status": "FAILURE").

Check the failed push notification delivery logs for any other Amazon SNS mobile app attributes. Then, follow the action listed for the status code in the Communicating with APN section on the Apple Developer website.

For more information with error codes and troubleshooting, see Handling notification responses from APNs on the Apple Developer website.

Device network connectivity issues

If the issue only occurs on a specific device, then make sure that the device isn't blocked from your network to receive push notifications. For example, your firewall might restrict traffic to allow push notifications on your network. For more information, see If your Apple devices aren't receiving Apple push notifications on the Apple website.

Deactivated Amazon SNS APNs endpoints

Endpoints get deactivated when push notifications sent to the endpoints don't have a valid device token associated with them. For more information, see How do I troubleshoot my deactivated push notification platform application with Amazon SNS?

Credentials aren't valid

Complete the following actions:

• If you use a certificate-based connection to your APNs, then make sure that you use the correct .p12 file for the certificates. For more information, see Using certificate-based authentication for iOS applications with Amazon SNS.
• If you use a token-based connection to your APNs, then make sure you use the correct .p8 file. For more information, see Token-based authentication for iOS applications with Amazon SNS.
• Make sure that you use the correct application ID certificates for your APNs created in Amazon SNS. For more information, see Sending mobile push notifications with Amazon SNS.
• Test publishing push notifications directly with Apple's Push Notification Console. For more information, see Testing notifications using the Push Notification Console on the Apple Developer website.

Messages show successful delivery but isn't displayed on the device

Complete the following actions:

• The message shows a successful delivery, but it's not displayed on the device. For example, the CloudWatch Logs show a successful delivery, but it's not displayed on the device's system tray. Include log statements in the receive message handler of the application. This helps to determine if the issue is with the notification not received by the device or not displayed in the system notifications tray. For more information, see Handling notifications and notification-related actions on the Apple Developer website.
• If messages receive as a notification payload but not as silent payload, then review the message handler in the client application code. Make sure that the received notification pushes to the device's system tray. For more information, see Pushing background updates to your App on the Apple Developer website.
• Check what the intended action is for the message types and verify that the client application is compatible. For more information, see Sending notification requests to APNs on the Apple Developer website.

Related information

How do I troubleshoot FCM mobile push notification failures in Amazon SNS?

Monitoring Amazon SNS topics using CloudWatch