Expo React Native应用生产环境启动崩溃：Qualities属性类型转换器缺失

核心问题拆解 #

崩溃的根因是找不到expo.modules.core.arguments.ReadableArguments的类型转换器，触发点是获取Qualities属性的时候。这一般是某个Expo模块在Kotlin层处理JS参数时，要么类型转换逻辑缺失，要么模块与当前Expo SDK版本不兼容导致的。

排查修复步骤 #

• 定位涉及Qualities的模块
  搜索代码中使用Qualities的位置，大概率是媒体、视频类的Expo模块（比如expo-av、第三方视频播放器模块）。重点检查：

  • 调用模块时是否直接传递了JS对象，未做正确类型转换
  • 该模块是否为最新稳定版，或是否与当前Expo SDK版本存在兼容性冲突

• 检查依赖兼容性
  执行expo doctor检测项目依赖冲突，修复所有版本不匹配的问题；如果使用了自定义Kotlin模块，需确保模块中正确实现了TypeConverter来处理ReadableArguments类型。

• 清理缓存并重新构建生产包

  • 清理Expo缓存：expo r -c
  • 清理Android构建缓存：进入项目android目录执行./gradlew clean
  • 重新生成生产构建：expo build:android 或 eas build

• 临时替换/降级可疑模块
  如果确定是某个模块导致崩溃，尝试将其降级到已知稳定版本，或替换为功能类似、兼容当前SDK的替代模块。

• 验证Hermes引擎兼容性
  生产环境使用Hermes时，确认涉事模块支持Hermes。可临时禁用Hermes测试：在app.json中修改配置：

  "android": {
    "jsEngine": "jsc"
  }
  

  若禁用后崩溃消失，说明模块存在Hermes兼容问题，需更新模块或向开发者反馈。

• 额外排查点

  • 若自定义了原生Kotlin/Java模块，检查是否遗漏了类型转换器的注册
  • 确认生产构建的配置与模拟器调试模式一致，排查是否因开启代码混淆导致异常

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