React Native突发TypeError问题求助：未启用远程调试却出现indexOf错误

一、你可能遗漏的排查/修复步骤 #

• 清理项目依赖与全局缓存

  • 删除项目根目录的node_modules、package-lock.json（或yarn.lock），重新执行npm install（或yarn install）
  • 清除npm/yarn全局缓存：

    npm cache clean --force
    # Yarn用户执行
    yarn cache clean
    

  • 清除React Native本地缓存并重启Metro：

    npx react-native start --reset-cache
    

• 检查Hermes配置是否异常

  • Android端：打开android/app/build.gradle，确认project.ext.react下的enableHermes为true（如果你原本启用了Hermes），之后重新执行./gradlew clean并重新编译
  • iOS端：打开Podfile，确认use_react_native!的配置包含:hermes_enabled => true，之后执行cd ios && pod deintegrate && pod install

• 清除设备端的应用残留状态

  • 彻底卸载模拟器/真机上的应用，然后：
    • Android：进入系统设置-应用-你的应用-存储，点击「清除数据」和「清除缓存」
    • iOS：在模拟器中通过「Hardware > Erase All Content and Settings」重置模拟器；真机卸载后重启设备
  • 排查项目代码中是否存在硬编码开启远程调试的逻辑，比如搜索NativeDevSettings.setIsDebuggingRemotely这类代码，确认没有被误添加

二、彻底重置Metro Bundler的方法 #

1. 关闭所有运行中的Metro Bundler进程：

   # Mac/Linux
   pkill -f "metro"
   # Windows：打开任务管理器，结束所有node.exe进程
   

2. 删除Metro相关缓存目录：

   rm -rf /tmp/metro-*
   rm -rf ./.cache  # 项目根目录的缓存文件夹
   rm -rf ./.metro  # 若存在该目录则删除
   

3. 重置缓存并启动Metro：

   npx react-native start --reset-cache
   

三、额外排查方向 #

• 回退最近的代码变更：检查近几日提交的代码，是否修改了babel配置、metro.config.js，或新增了可能冲突的依赖，尝试回退到之前能正常运行的版本验证
• 临时禁用Hermes测试：将Android和iOS的Hermes配置改为false，重新编译运行，若问题消失则可能是Hermes版本与RN版本不兼容，尝试升级/降级Hermes或RN版本
• 检查Metro配置文件：确认metro.config.js中没有异常的自定义配置，比如修改了模块解析规则，可临时替换为默认配置测试

内容的提问来源于stack exchange，提问作者Gavara.Suneel