You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

集成react-native-web后Android端报Catalyst Instance已消失错误

Catalyst Instance has already disappeared: requested by FrescoModule 报错本质是React Native Android端的JS运行时实例在Fresco图片库请求调用时已被销毁,你在集成react-native-web过程中修改的配置大概率触发了依赖冲突、重复初始化或者入口加载错误的问题。


解决步骤

  1. 全量清理项目缓存
    执行如下命令清理冗余缓存后重试:
    Windows环境执行:
del node_modules package-lock.json
npm install
cd android && gradlew.bat clean
cd .. && npx react-native start --reset-cache

macOS/Linux环境执行:

rm -rf node_modules package-lock.json
npm install
cd android && ./gradlew clean
cd .. && npx react-native start --reset-cache
  1. 移除Fresco重复初始化配置
    打开android/app/src/main/java/[你的包名路径]/MainApplication.java文件,检查onCreate方法中的Fresco初始化逻辑,React Native 0.65及以上版本默认已经内置Fresco初始化,如果你在配置react-native-web过程中额外添加了Fresco.initialize调用,删除多余的初始化代码即可。

  2. 强制指定Fresco依赖版本
    打开android/app/build.gradle文件,在dependencies块同级位置添加如下配置,锁定Fresco版本和当前React Native 0.65.1适配:

configurations.all {
    resolutionStrategy {
        force "com.facebook.fresco:fresco:2.5.0"
        force "com.facebook.fresco:imagepipeline-okhttp3:2.5.0"
    }
}

修改完成后重新执行react-native run-android编译启动项目。

  1. 修正Metro配置的扩展名优先级
    检查项目根目录的metro.config.js文件,确认扩展名配置中,原生支持的扩展名排在web相关扩展名之前,避免Android端误加载web适配代码:
module.exports = {
  resolver: {
    // 注意原生扩展名在前,web扩展名在后
    sourceExts: ['jsx', 'js', 'ts', 'tsx', 'json', 'web.js', 'web.jsx', 'web.ts', 'web.tsx']
  }
};

内容的提问来源于stack exchange,提问作者Jhelsin Mijael Quispe Garcia

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.02 11:15:06