React Native Track Player运行报错：无法解析@ReactMethod注解

核心原因 #

React Native 0.76.x的TurboModule系统不支持原生模块方法返回kotlinx.coroutines.Job类型，而React Native Track Player 4.1.1的add()方法恰好返回该类型，导致JNI签名解析失败，触发应用崩溃。

解决方案 #

方案1：升级React Native Track Player到兼容版本 #

React Native Track Player后续版本已修复与RN 0.76+的兼容性问题，建议升级至v4.2.0及以上版本：

• 卸载旧版本：

  npm uninstall react-native-track-player
  

• 安装兼容版本：

  npm install react-native-track-player@latest
  

• 清理并同步Android项目：

  cd android && ./gradlew clean && cd ..
  

• 重新运行应用：

  npx react-native run-android
  

方案2：临时修改原生模块代码（应急用，不推荐长期使用） #

如果无法立即升级库，可临时修改react-native-track-player的Android原生代码，将返回Job的方法改为返回Unit：

1. 打开node_modules/react-native-track-player/android/src/main/java/com/doublesymmetry/trackplayer/modules/TrackPlayerModule.kt
2. 找到add()方法，修改返回类型与逻辑：

   // 原代码
   @ReactMethod
   fun add(tracks: ReadableArray, insertBeforeIndex: Int): Job {
       return player.add(tracks.toMediaItems(), insertBeforeIndex)
   }
   
   // 修改后
   @ReactMethod
   fun add(tracks: ReadableArray, insertBeforeIndex: Int) {
       player.add(tracks.toMediaItems(), insertBeforeIndex)
   }
   

3. 重新构建并运行应用

方案3：降级React Native版本 #

若上述方案都无法实施，可将React Native降级到0.75.x版本（该版本TurboModule系统对返回类型限制较宽松）：

• 降级RN核心依赖：

  npm install react-native@0.75.4
  

• 清理并同步项目后重新运行：

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

验证步骤 #

1. 确认项目无编译错误，构建成功
2. 在Android设备运行应用，检查是否仍出现崩溃
3. 调用TrackPlayer的add()方法，验证音乐播放功能正常

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