React Native集成导航库后编译失败：react-native-gesture-handler报错求助

问题根源 #

错误源于React Native 0.76.1与react-native-gesture-handler 2.20.2的版本兼容性冲突，新版本手势库的CMake自动链接逻辑和RN 0.76的构建流程不匹配，导致出现目标模块找不到、CMake参数错误的问题。

步骤1：降级react-native-gesture-handler #

安装适配RN 0.76的稳定版本：

npm install react-native-gesture-handler@2.19.0

步骤2：清理依赖缓存 #

删除旧依赖和锁文件，重新安装：

rm -rf node_modules package-lock.json
npm install

步骤3：清理Android构建缓存 #

进入Android目录清理残留构建文件：

cd android
./gradlew clean
cd ..

步骤4：重新运行项目 #

npx react-native run-android

额外排查点 #

• 确认未手动修改过android/app/build.gradle或CMakeLists.txt中的自动链接配置
• 若使用Yarn，将上述npm命令替换为Yarn对应操作

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