react-native-agora-chat与RN0.76.1集成报错求助

错误1：原生模块解析异常（JNI签名解析失败） #

Exception in HostObject::get for prop 'ExtSdkApiRN': com.facebook.react.internal.turbomodule.core.TurboModuleInteropUtils$ParsingException: Unable to parse @ReactMethod annotation from native module method: ExtSdkApiRN.listeners(). Details: Unable to parse JNI signature. Detected unsupported return class: java.lang.Object[]

解决方法 #

这个问题是RN 0.76+的TurboModule对JNI方法签名的校验更严格，而该alpha版本的SDK中ExtSdkApiRN.listeners()方法返回了不被支持的Object[]类型。

• 临时修复（无需等官方更新）：

  1. 找到SDK的Android原生文件：node_modules/react-native-agora-chat/android/src/main/java/io/agora/reactnative/chat/ExtSdkApiRN.java
  2. 修改listeners()方法：将返回类型从Object[]改为List<Object>，同时更新@ReactMethod的签名适配新类型；如果你的业务暂时用不到这个方法，直接注释掉也可以
  3. 执行cd android && ./gradlew clean清理编译缓存，然后重新运行项目

• 长期方案：等待官方发布适配RN 0.76+的正式版本，或者向官方提交PR修复该方法的返回类型问题。

错误2：TypeError: Cannot read property 'ChatClient' of undefined #

执行代码const chatClient = ChatClient.getInstance();时触发

解决方法 #

该问题通常是SDK未正确初始化或模块链接失败导致的，按以下步骤排查：

• 1. 确保先初始化再调用getInstance
     在App启动的入口文件（如App.tsx/App.js）中，必须先调用初始化方法，再获取实例：

  import { ChatClient } from 'react-native-agora-chat';
  
  // 在组件挂载或App启动时执行初始化
  useEffect(() => {
    ChatClient.init({ appKey: '你的声网APP_KEY' });
  }, []);
  
  // 之后再调用getInstance
  const getChatClient = () => {
    const chatClient = ChatClient.getInstance();
    // 后续操作
  };
  

• 2. 检查模块链接与缓存
  • 执行npx react-native link react-native-agora-chat强制重新链接模块
  • 清理Metro缓存：npx react-native start --reset-cache
• 3. 校验iOS/Android项目配置
  • iOS：进入ios目录执行pod install --repo-update，确保Pod依赖正确安装
  • Android：检查android/app/build.gradle中是否正确引入SDK依赖，AndroidManifest.xml是否添加了必要的网络权限
• 4. 临时回退到旧架构（如果TurboModule兼容问题）
     在metro.config.js中添加配置，强制使用RN旧架构：

  module.exports = {
    resolver: {
      unstable_enablePackageExports: false,
    },
  };
  

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