如何从Firebase Crashlytics堆栈追踪的bundle文件定位报错源码位置

要还原压缩后的bundle堆栈对应的源码信息，核心前提是你保留了对应APP版本打包时生成的sourcemap文件，版本不匹配的情况下任何工具都无法准确解析。

方法1：使用RN官方自带的metro-symbolicate工具（准确度最高） #

metro-symbolicate是React Native官方维护的堆栈解析工具，比第三方的stack-beautifier适配性更强：

• 首先找到对应版本打包生成的sourcemap，安卓release包默认生成路径为：android/app/build/generated/sourcemaps/react/release/index.android.bundle.map
• 把Crashlytics导出的完整堆栈文本保存为crash.txt，不要修改堆栈里的行列号格式
• 执行以下命令直接输出还原后的堆栈：

npx metro-symbolicate 你的sourcemap文件路径 < crash.txt

输出结果会直接显示每一行堆栈对应的源文件路径、函数名、源码行列号。

方法2：自行编写脚本解析（适合批量处理/定制需求） #

可以直接调用npm的source-map包实现自定义解析，示例代码如下：

const { SourceMapConsumer } = require('source-map');
const fs = require('fs');

// 加载对应版本的sourcemap文件
const sourceMapContent = JSON.parse(fs.readFileSync('./index.android.bundle.map', 'utf8'));

async function getOriginalPosition(bundleLine, bundleColumn) {
  const consumer = await new SourceMapConsumer(sourceMapContent);
  const result = consumer.originalPositionFor({
    line: bundleLine,
    column: bundleColumn
  });
  consumer.destroy();
  return result;
}

// 解析示例中的474行6500列
getOriginalPosition(474, 6500).then(res => {
  console.log('源文件路径：', res.source);
  console.log('源码行号：', res.line);
  console.log('源码列号：', res.column);
  console.log('对应函数名：', res.name);
})

常见解析失败的原因 #

• sourcemap版本和崩溃的APP版本不对应，每次发版必须存档对应版本的sourcemap文件
• 如果你开启了Hermes引擎，需要使用Hermes编译阶段生成的sourcemap，而非metro打包输出的sourcemap，同时可以使用Hermes专属的解析命令：

  npx react-native symbolicate --platform android crash.txt
  

• 也可以直接将sourcemap上传到Firebase Crashlytics后台，后续崩溃报告会自动完成符号化，无需手动解析。

内容的提问来源于stack exchange，提问作者Ed of the Mountain