已配置AWS Auth的React Native应用集成AWS Pinpoint推送及报错排查
现有已配置Auth的React Native应用集成AWS Pinpoint推送方案&报错排查
报错根因
调用aws pinpoint send-messages返回NotFoundException,核心原因是你本地日志打印的endpointId,在对应Pinpoint服务端根本没有生成完整的可用endpoint记录。常见触发原因包括:手动配置参数不匹配、设备FCM token没有同步到Pinpoint、配置的Pinpoint Region和实际项目所在Region不一致、身份池权限不足导致endpoint更新请求被拦截。
逐步骤补全遗漏配置
- 优先用CLI同步配置,不要手动硬写Amplify参数
直接在现有项目里运行amplify add notifications,选择Push Notification选项,按提示关联已经配置好的现有Auth资源、选择你已经创建完成的Pinpoint项目、填入之前保存的FCM服务器密钥,最后运行amplify push同步配置。这个步骤会自动把正确的Pinpoint appId、Region、推送权限配置注入到aws-exports.js文件里,省得手动写配置把参数填错。 - 补全Android端推送链路初始化逻辑
确认以下配置全部落地:- 已将对应Firebase项目的
google-services.json文件放到android/app目录下,且在android/app/build.gradle中加入了匹配版本的Firebase Messaging依赖 - 把推送初始化逻辑放到应用入口文件(如
index.js),在Amplify.configure执行完成后立刻初始化,不要等组件挂载后再触发:// 入口文件 index.js import Amplify from 'aws-amplify'; import awsconfig from './aws-exports'; // 先加载所有Amplify配置(包含自动注入的Pinpoint推送配置) Amplify.configure(awsconfig); import PushNotification from 'react-native-push-notification'; PushNotification.configure({ onRegister: async (token) => { const pinpointClient = Amplify.Analytics.getPluggable('AWSPinpoint'); // 拿到FCM token后手动完成endpoint同步,这步是生成有效endpoint的核心 await pinpointClient.updateEndpoint({ address: token.token, channelType: 'GCM' }) }, onNotification: (notification) => { /* 原有通知接收逻辑 */ }, onNotificationOpened: (notification) => { /* 原有通知打开逻辑 */ }, senderId: '你的Firebase Sender ID', permissions: { alert: true, badge: true, sound: true }, popInitialNotification: true, requestPermissions: Platform.OS === 'ios' }) - 确认配置里的Pinpoint Region和你实际创建Pinpoint项目的Region完全一致——很多人习惯把所有AWS服务的Region设成和Auth一样的区域,很容易把Pinpoint建在别的Region下,导致请求打错服务端查不到endpoint。
- 已将对应Firebase项目的
- 先验证endpoint有效性,再发测试消息
完成上述初始化、冷启动应用一次后,不要直接拿本地打印的endpoint ID发测试消息,先调用Pinpoint查询接口确认endpoint已经在服务端生成:
运行aws pinpoint get-endpoint --application-id 你的Pinpoint项目ID --endpoint-id 本地拿到的endpointId- 如果接口返回完整的endpoint信息(包含有效FCM token、ChannelType为GCM),再执行发送操作
- 如果接口还是返回NotFound,检查
onRegister回调里的updateEndpoint请求是否有报错,确认Cognito身份池已经开放Pinpoint的UpdateEndpoint权限,没有拦截同步请求。
高频踩坑提醒
- 不要把本地生成的
endpointId直接当成服务端有效ID:这个值只是本地生成的随机UUID,只有成功向Pinpoint发送一次带设备token的updateEndpoint请求后,服务端才会生成对应的可查询记录。 - 应用完成登录流程后,记得把Pinpoint endpoint的
userId关联为当前登录用户的Cognito用户ID,不然后续做用户维度推送时会找不到对应endpoint。 - 测试消息的请求配置里,
ApplicationId要填Pinpoint项目的全局ID(可在Pinpoint控制台项目设置页直接复制),不要填客户端的client ID,不然会直接匹配错误项目下的资源。
内容的提问来源于stack exchange,提问作者Munish
相关产品推荐
相关产品推荐

