React Native 0.71.3调试时出现console.assert is not a function错误的原因与解决办法

问题产生原因 #

• 全局console对象被篡改：项目里的自定义代码或第三方库可能重写了全局console，不小心删掉了assert方法，调试模式下JS在浏览器环境运行时就会触发这个错误。
• 调试工具与版本适配问题：React Native 0.71.3和默认的Chrome DevTools可能存在兼容性问题，导致console对象的方法没有被正确注入到调试环境中。
• Metro缓存残留：Metro bundler的缓存里可能存了旧的代码片段，导致调试时加载的console对象不完整。

解决办法 #

• 排查并修复console篡改：搜索项目中所有修改全局console的代码，比如delete console.assert、console = {...}这类操作，要么恢复assert方法，要么改成局部覆盖而非全局修改。
• 重置Metro缓存：执行命令 npx react-native start --reset-cache，清空缓存后重新启动调试服务。
• 更换调试工具：如果Chrome调试出问题，试试React Native Debugger，iOS项目也可以切换到Safari进行调试。
• 手动补全console.assert：在项目入口文件（如index.js或App.js）中添加以下代码，确保方法存在：

if (!console.assert) {
  console.assert = function(condition, message, ...args) {
    if (!condition) {
      console.error(`Assertion failed: ${message || ''}`, ...args);
    }
  };
}

• 检查第三方依赖：排查项目中与RN 0.71.3不兼容的第三方库，尝试更新到兼容版本，或者暂时移除可疑库验证问题是否消失。

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