RN-Android：react-native-keychain跨应用读凭证失败及链接报错

一、手动链接报错解决 #

报错信息明确指出模块重复注册，React Native 0.60+版本默认开启自动链接，手动添加KeychainPackage会导致冲突。解决步骤：

1. 打开MainApplication.java，移除手动添加的new KeychainPackage()代码
2. 清理项目缓存：

   cd android && ./gradlew clean
   cd .. && npx react-native clean
   

3. 重新编译运行即可。若确需覆盖现有模块（不推荐），可修改代码为：

   new KeychainPackage() {
       @Override
       public boolean canOverrideExistingModule() {
           return true;
       }
   }
   

二、跨应用凭证读取问题解决 #

Android对跨应用数据访问有严格权限限制，需满足以下条件：

1. 统一签名与共享UserId #

• 确保App A和App B使用完全相同的签名证书（debug包默认共用debug.keystore，release包必须用同一签名文件）
• 在两个App的AndroidManifest.xml的<manifest>标签中添加相同的共享UserId：

  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.demo.appa"
      android:sharedUserId="com.demo.shared">
  

  （App B的package可不同，但sharedUserId必须完全一致）

2. 调整Keychain调用参数 #

存储和读取凭证时，需指定统一的sharedPreferencesName和service，确保两个App访问同一存储容器：

// App A 存储凭证
const storeData = async () => {
  const result = await Keychain.setGenericPassword(
    'credentials',
    'test_user@demo.com|test123',
    {
      service: 'com.demo.cred',
      sharedPreferencesName: 'com.demo.shared_keychain', // 统一存储名称
      sharedPreferencesOptions: {
        mode: Keychain.SHARED_PREFERENCES_MODE_PRIVATE // 同签名+sharedUserId下可跨应用访问
      },
    },
  );
  console.log('存储结果:', result);
};

// App B 读取凭证
const getData = async () => {
  const credentials = await Keychain.getGenericPassword({
    service: 'com.demo.cred',
    sharedPreferencesName: 'com.demo.shared_keychain', // 与存储时一致
    sharedPreferencesOptions: {
      mode: Keychain.SHARED_PREFERENCES_MODE_PRIVATE
    },
  });
  console.log('读取到的凭证:', credentials);
};

3. 注意事项 #

• 禁止使用SHARED_PREFERENCES_MODE_WORLD_READABLE或WORLD_WRITEABLE，避免安全漏洞，同签名+sharedUserId的App用MODE_PRIVATE即可实现共享
• 若仍无法读取，检查两个App的targetSdkVersion是否一致，高版本Android对跨应用访问有额外限制
• 确保react-native-keychain为最新稳定版，旧版本可能存在跨应用共享Bug

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