Amplify/Cognito 集成后 Pinpoint 无用户事件分析数据如何解决

问题排查与解决方案 #

1. 缺失Analytics模块安装与导入 #

你当前依赖清单中没有@aws-amplify/analytics包，且代码中未导入该模块。Amplify v4采用模块化架构，@aws-amplify/core不会默认加载Analytics能力，即使你在配置中填写了Analytics相关参数也不会生效，这和你抓不到上报请求的现象完全吻合。
解决步骤：

• 安装对应版本的Analytics依赖，和现有Amplify包版本对齐避免兼容性问题：

npm install @aws-amplify/analytics@4.0.3

• 在Amplify初始化文件顶部导入Analytics模块：

import Amplify from "@aws-amplify/core";
import Analytics from "@aws-amplify/analytics"; // 新增导入

2. 缺失Cognito身份池配置 #

Amplify Analytics调用Pinpoint接口需要Cognito身份池下发的临时AWS凭证，你当前的Auth配置仅包含用户池相关参数，缺少身份池ID配置。
解决步骤：

• 到AWS控制台获取和当前用户池关联的Cognito身份池ID，在Auth配置中补充对应字段：

Auth: {
  region: ENV.REGION,
  userPoolId: ENV.USER_POOL_ID,
  userPoolWebClientId: ENV.USER_POOL_CLIENT_ID,
  identityPoolId: ENV.IDENTITY_POOL_ID, // 新增身份池ID配置
  // 其余原有配置保持不变
  authenticationFlowType: ENV.AUTHENTICATION_FLOW_TYPE,
  oauth: {
    // 原有oauth配置
  }
}

• 确认你已配置的包含mobiletargeting:UpdateEndpoint、mobiletargeting:PutEvents权限的策略，正确绑定到Cognito身份池对应的认证用户角色（如果允许未登录用户上报，也需要给未认证用户角色绑定该策略）。

3. 开启Auth事件自动跟踪 #

Amplify默认不会自动上报登录、注册等认证事件，需要在Analytics配置中开启自动跟踪：

Analytics: {
  AWSPinpoint: {
    region: ENV.REGION,
    appId: ENV.PINPOINT_APP_ID,
    autoTrack: {
      enable: true,
      auth: true, // 开启认证事件自动上报
      // 按需可开启页面访问、交互事件上报：
      // pageView: true,
      // event: true
    }
  }
}

4. 调试日志排查 #

如果完成以上配置后仍无数据上报，可开启Amplify调试日志定位问题：
在Amplify.configure前添加日志级别配置：

Amplify.Logger.LOG_LEVEL = 'DEBUG';

运行应用执行登录操作，查看控制台中Analytics相关的报错信息，可快速定位是权限问题、配置错误还是网络问题。

内容的提问来源于stack exchange，提问作者xtra