React Native正式包报JavascriptException: includes of undefined如何解决
问题排查与解决方案
核心报错根因说明
该报错本质是JavaScript运行时对undefined类型的变量调用了includes方法触发的异常,Release包因开启代码混淆所以调用栈显示为单字母缩写,结合你使用Hermes引擎、Facebook登录的场景,可按以下方向排查:
排查方向
- 优先定位报错对应的源码位置:使用Release构建时生成的SourceMap文件,解析报错栈中
S@1:1887428对应的具体业务代码行,可直接定位调用includes的位置。如果没有保留SourceMap,可打一个关闭代码混淆的Release包直接复现,栈信息会直接显示源码文件名和行号。 - 重点核查Facebook登录相关逻辑:优先检查Facebook登录回调处理、用户信息字段读取、权限校验相关代码,大概率是Facebook返回的用户字段为空(比如用户拒绝了邮箱/昵称权限、特殊地区用户返回字段缺失),你直接对未定义的字段调用
includes触发报错,比如user.email.includes('xxx')这种写法,email字段不存在时就会触发该异常。 - 排查全项目的
includes调用场景:检查所有调用includes的代码是否做了空值校验,Debug包可能因为测试场景覆盖不全、mock数据兜底没触发问题,Release包线上真实场景出现空值就会报错。 - Hermes适配性排查:排查项目是否存在Polyfill冲突,Hermes本身完全支持ES6+的
includes方法,概率极低但如果有自定义垫片覆盖了原生方法也可能触发该问题。
解决方案
- 全局修复所有
includes调用的空值校验:把所有str.includes('xxx')的写法改为可选链式调用str?.includes('xxx'),或者手动增加非空判断if (str && str.includes('xxx')),从根源避免空值调用。 - 针对Facebook登录返回值做全兜底:所有从Facebook SDK获取的返回字段都设置默认空值,比如
const { email = '', name = '', permissions = [] } = loginResult || {},确保后续调用方法的字段一定是预期的字符串/数组类型。 - 增加全局异常防护:在React根组件外层增加ErrorBoundary,捕获这类JS运行时异常,避免App直接闪退,同时可上报异常触发时的上下文参数,方便后续定位其他同类问题。
- 补充边界场景测试:上线前针对Facebook登录的异常场景做测试,比如拒绝所有授权权限、使用无绑定邮箱的Facebook账号登录,覆盖边界情况。
内容的提问来源于stack exchange,提问作者SimoneMeta
相关产品推荐
相关产品推荐

