React Native中AWS Cognito与Amplify未认证用户身份持久化问题

我之前在集成Amplify和Pinpoint的时候也碰到过一模一样的问题，关闭应用再打开就丢了身份ID，折腾了好一阵才找到根源，给你分享几个亲测有效的解决方向：

核心原因 #

默认情况下，Amplify对未认证用户的身份缓存依赖React Native的本地存储（AsyncStorage），如果存储配置不对、Amplify初始化没开启缓存，或者身份池设置有问题，就会导致身份ID无法持久化，每次重启都生成新的。

具体解决方案 #

1. 正确配置Amplify的Auth模块，绑定AsyncStorage #

从React Native 0.60版本开始，AsyncStorage被移到了独立包，所以首先要确保你安装了@react-native-async-storage/async-storage：

npm install @react-native-async-storage/async-storage
# 或者用yarn
yarn add @react-native-async-storage/async-storage

然后在Amplify初始化时，手动指定storage并开启缓存：

import Amplify from 'aws-amplify';
import AsyncStorage from '@react-native-async-storage/async-storage';
import awsconfig from './aws-exports';

Amplify.configure({
  ...awsconfig,
  Auth: {
    ...awsconfig.Auth,
    // 绑定AsyncStorage作为本地缓存载体
    storage: AsyncStorage,
    // 开启未认证访问
    allowGuestAccess: true,
    // 配置缓存有效期，这里设为一年，按需调整
    cache: {
      defaultTTL: 365 * 24 * 60 * 60 * 1000,
      capacityInBytes: 10485760,
    }
  }
});

2. 使用Amplify官方API获取未认证身份 #

不要手动生成身份ID，一定要用Amplify提供的方法来获取，这样会自动优先读取缓存：

• 如果你用的是Amplify v5+，推荐用Auth.signInAnonymously()：

import { Auth } from 'aws-amplify';

const getPersistentGuestId = async () => {
  try {
    // 尝试获取已缓存的匿名用户
    const anonymousUser = await Auth.signInAnonymously();
    console.log('持久化身份ID:', anonymousUser.userSub);
    return anonymousUser.userSub;
  } catch (error) {
    console.error('获取匿名身份失败:', error);
    // 这里可以根据错误类型处理，比如网络问题等
  }
};

• 如果你用的是v4版本，可以用Auth.currentCredentials()：

import { Auth } from 'aws-amplify';

const getPersistentGuestId = async () => {
  try {
    const credentials = await Auth.currentCredentials();
    console.log('持久化身份ID:', credentials.identityId);
    return credentials.identityId;
  } catch (error) {
    console.error('获取身份失败:', error);
  }
};

3. 检查Cognito身份池的未认证访问设置 #

登录AWS控制台，进入你的Cognito身份池，确保：

• 未认证访问已开启（在“编辑身份池”页面的“访问权限”部分）
• 身份池的权限策略允许未认证用户访问Pinpoint（比如允许mobiletargeting:PutEvents操作）
• “身份验证提供程序”中已启用“未认证身份”

4. 清除旧缓存后重新测试 #

如果之前有错误的缓存数据干扰，先清除应用缓存（卸载重装或者在调试时调用AsyncStorage.clear()），然后重新初始化Amplify，再测试身份是否持久化。

额外注意事项 #

• 版本兼容性：不同Amplify版本的API有差异，比如v4和v5的Auth方法变化很大，建议对照你使用的版本调整代码
• 事件发送时机：确保在获取到身份ID之后再发送Pinpoint事件，这样事件才会关联到正确的持久化身份：

import { Analytics } from 'aws-amplify';

const sendPinpointEvent = async (eventName, attributes = {}) => {
  // 先确保身份已加载
  await getPersistentGuestId();
  // 发送事件
  await Analytics.record({
    name: eventName,
    attributes: attributes,
  });
};

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