使用patch-package修补React Native无效问题求助

问题描述 #

我在修复React Native问题时，先fork了RN仓库，修改Java文件后通过rn-tester App验证修复有效。但将相同修复代码添加到项目node_modules/react-native下的对应文件，并用patch-package打补丁后，修复却未生效：

• 删除node_modules重新安装后，Java文件中确实存在修复代码
• 运行npm run android后，原问题依旧存在
• 添加的Log.d或System.out.println日志完全没有输出

操作步骤：

1. 修改/node_modules/react-native/ReactAndroid/.../somefiles.java添加修复代码
2. 执行npx patch-package react-native，并在package.json的scripts中添加"postinstall": "npx patch-package"
3. 删除node_modules并执行npm i
4. 确认修复代码存在后执行npm run android
5. 问题未解决

预期：rn-tester中验证有效的修复应在项目中生效

排查与修复步骤 #

1. 清理Android构建缓存 #

React Native Android默认会缓存编译产物，旧的class文件可能覆盖了你的修复代码：

# 进入Android目录
cd android
# 清理构建缓存
./gradlew clean
# 返回根目录重新构建
cd ..
npm run android

Windows环境替换为gradlew clean

2. 确保项目依赖本地ReactAndroid源码而非预编译AAR #

部分RN版本默认使用预编译的AAR包，而非直接编译node_modules下的源码，导致补丁代码不参与编译：

• 打开android/app/build.gradle，找到RN依赖行：

  implementation 'com.facebook.react:react-native:+'
  

  替换为依赖本地模块：

  implementation project(':react-native')
  

• 检查android/settings.gradle是否包含RN模块引用：

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

  若不存在则添加

3. 验证日志输出 #

确认日志是否真的未输出，而非过滤问题：

• 使用ADB查看全量日志：

  adb logcat *:V
  

• 或者过滤你设置的TAG（假设TAG为MyFixLog）：

  adb logcat -s MyFixLog
  

• 确保Java代码中的日志写法正确：

  import android.util.Log;
  // ...
  Log.d("MyFixLog", "修复逻辑执行标记");
  

4. 检查patch-package补丁文件 #

打开patches/react-native+[你的RN版本号].patch，确认：

• 文件路径完全匹配ReactAndroid下的目标Java文件（注意大小写，跨系统可能出现差异）
• 代码变更与rn-tester中验证的完全一致，没有遗漏或错误
• 补丁文件格式正确，没有语法错误

5. 清理Hermes缓存（若启用Hermes） #

如果项目使用Hermes引擎，缓存的字节码可能未更新：

• 删除android/app/build/generated/assets/react/debug或release目录下的Hermes相关文件
• 重新执行npm run android

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