React Native使用react-native-contacts时getAll为null的TypeError问题

核心问题说明 #

这个错误的本质是你导入的Contacts模块本身为null，说明react-native-contacts库没有被正确加载到React Native项目中，并非权限问题（你已经确认权限已授予）。以下是逐一排查的解决步骤：

1. 检查导入方式是否正确 #

react-native-contacts v8.x版本采用默认导出，错误的解构导入会导致模块为null：

// 正确写法
import Contacts from 'react-native-contacts';

// 错误写法（不要用这种）
import { Contacts } from 'react-native-contacts';

2. 确认Android端自动链接完成 #

虽然RN 0.60+支持自动链接，但仍可能出现链接异常：

• 执行命令清理Android构建缓存并重建：

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

• 手动检查配置文件：
  • 打开android/settings.gradle，确认包含以下内容：

    include ':react-native-contacts'
    project(':react-native-contacts').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-contacts/android')
    

  • 打开android/app/build.gradle，确认依赖中包含：

    implementation project(':react-native-contacts')
    

3. 补全Android权限配置细节 #

除了在AndroidManifest.xml中添加权限，还要注意：

• 权限必须放在<manifest>标签下（而非<application>内部）：

  <uses-permission android:name="android.permission.READ_CONTACTS" />
  <uses-permission android:name="android.permission.WRITE_CONTACTS" />
  

• Android 13+需确保动态申请权限的逻辑在调用getAll之前执行，示例代码：

  import { PermissionsAndroid } from 'react-native';
  
  const requestContactsPermission = async () => {
    const granted = await PermissionsAndroid.request(
      PermissionsAndroid.PERMISSIONS.READ_CONTACTS,
      {
        title: "联系人权限申请",
        message: "应用需要访问您的联系人列表",
        buttonPositive: "确定"
      }
    );
    return granted === PermissionsAndroid.RESULTS.GRANTED;
  };
  
  const fetchContacts = async () => {
    const hasPermission = await requestContactsPermission();
    if (!hasPermission) return;
    
    try {
      const contacts = await Contacts.getAll();
      console.log('联系人列表:', contacts);
    } catch (error) {
      console.error('获取联系人失败:', error);
    }
  };
  

4. 清理项目缓存 #

缓存残留可能导致模块加载异常，执行以下命令：

# 重置RN Metro缓存
npx react-native start --reset-cache

# 删除依赖并重新安装（Windows系统替换rm命令为rmdir /s /q node_modules）
rm -rf node_modules && npm install

# 清理Android构建缓存
cd android && ./gradlew cleanBuildCache

5. 检查ProGuard混淆配置（若开启） #

如果你的项目启用了ProGuard，需在android/app/proguard-rules.pro中添加规则避免库代码被混淆：

-keep class com.rt2zz.reactnativecontacts.** { *; }
-keepclassmembers class com.rt2zz.reactnativecontacts.** { *; }

6. 版本兼容性验证 #

确认react-native-contacts v8.0.4与RN 0.76.4的兼容性，若上述步骤无效，可尝试切换库版本：

# 降级到v7.x版本
npm install react-native-contacts@7.0.0

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