Expo SDK-38中RCTText节点numberOfLines属性更新错误的原因及解决方法

致命异常：java.lang.RuntimeException: Expo遇到致命错误：更新类型为RCTText的阴影节点的'numberOfLines'属性时出错
堆栈信息：
host.exp.exponent.experience.BaseExperienceActivity$2.run(BaseExperienceActivity.java:206)
at android.os.Handler.handleCallback(Handler.java:883)
at android.os.Handler.dispatchMessage(Handler.java:100)
at android.os.Looper.loop(Looper.java:214)
at android.app.ActivityThread.main(ActivityThread.java:7356)
at java.lang.reflect.Method.invoke(Method.java)
at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:492)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:930)

我之前在Expo SDK 38开发时也碰到过这个一模一样的问题，核心原因很明确：Text组件的numberOfLines属性接收到了非预期的类型值。在SDK38的原生RCTText实现里，这个属性要求必须是有效的整数类型，如果传入了字符串、undefined、null或者NaN，原生层在更新阴影节点时就会因为类型转换失败抛出这个致命异常。

常见的错误场景包括：

• 直接传递字符串格式的数字，比如 <Text numberOfLines="3">...</Text>
• 从props/state或接口获取的值未做类型处理，比如接口返回的字符串类型数字
• 条件渲染时未给numberOfLines设置默认值，导致传入undefined

按以下步骤排查和修复即可：

• 全局检查numberOfLines的使用：搜索项目中所有用到numberOfLines的Text组件，确保传入的是数字类型（用大括号包裹，比如{3}而不是"3"）。
• 处理动态值的类型转换：如果numberOfLines的值来自外部数据，一定要转换成数字类型，示例：

  // 正确写法：转换类型+默认值兜底
  <Text numberOfLines={parseInt(props.maxLines) || 1}>...</Text>
  

• 添加默认值防御：如果存在可能没有值的场景，给numberOfLines设置一个默认数字，避免传入空值：

  <Text numberOfLines={maxLines ?? 2}>...</Text>
  

• 清除Expo缓存：有时候缓存的旧代码会引发奇怪的兼容性问题，运行以下命令重置缓存：

  expo r -c
  

• 考虑升级Expo SDK：SDK38属于比较旧的版本，后续的SDK（比如40及以上）修复了不少原生组件的类型校验问题，稳定性更好。如果项目允许，建议升级到较新的稳定版本。

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