Flutter用Amplify上报AWS Pinpoint事件延迟且无法触发Journey问题求助

一、事件上报10-20分钟延迟问题排查 #

• 首先确认依赖版本问题：你当前使用的amplify_flutter: ^0.2.4、amplify_analytics_pinpoint: ^0.2.4是2021年的旧版本，存在已知的手动flush不生效bug：即使主动调用Amplify.Analytics.flushEvents()，SDK仍然会优先走默认的10分钟批量上报周期，导致事件延迟发送。建议将Amplify相关依赖升级到最新稳定版即可修复该问题。
• 检查数据流中转配置：确认你没有为Pinpoint项目配置Kinesis Data Firehose等流式中转服务，这类服务默认会开启1-15分钟的缓冲窗口，积攒数据达到阈值后才会写入Pinpoint，也会导致事件延迟。
• 本地调试验证：在移动端侧添加网络请求日志，确认调用flushEvents后是否立即发起Pinpoint的事件上报HTTP请求，排除本地网络、代理导致的请求延迟。

二、事件上报后未触发旅程问题排查 #

• 先确认事件触发的基础规则：Pinpoint旅程仅会被实时上报的事件触发，延迟超过旅程配置的触发窗口期的事件会被直接判定为历史事件，不会触发任何旅程逻辑，需要先解决事件延迟问题再验证旅程触发逻辑。
• 校验事件与分群匹配规则：
  • 确认旅程配置的触发事件名与你上报的_app.login完全一致，包括大小写、特殊符号，无拼写错误。
  • 确认测试用户确实属于目标分群：Pinpoint分群默认刷新周期为24小时，刚添加属性的用户不会立即同步到分群，你可以手动触发分群刷新，或者先将旅程的分群限制关闭做基础验证。
• 校验用户属性配置：
  • 你需要在用户登录后主动调用Amplify.Analytics.identifyUser()方法，将当前登录的userId、邮箱地址等属性绑定到当前设备端点，否则Pinpoint无法将上报的事件和对应的用户档案匹配，也就无法判定用户所属分群、也无法获取邮箱地址发信。
  • 确认该用户的Pinpoint档案中存在有效的邮箱地址，且邮箱未被标记为退信、投诉、黑名单状态。
• 校验旅程与发信配置：
  • 确认旅程处于运行中状态，草稿、暂停状态的旅程不会被触发，也不会产生指标数据。
  • 确认AWS SES发件邮箱已经完成验证，若你的SES账号处于沙箱模式，收件邮箱也需要提前完成验证才能收到测试邮件。

快速定位验证方法 #

你可以直接通过Pinpoint控制台的「测试事件」功能，手动上报一条_app.login事件，携带对应用户的userId属性，若手动上报可以触发旅程，说明问题出在客户端上报逻辑/事件延迟上；若手动上报也无法触发，说明问题出在旅程配置、用户分群、属性匹配逻辑上。

内容的提问来源于stack exchange，提问作者Merouane T.