如何在Crashlytics Android NDK中符号化libart.so等系统库堆栈

注意：自有C++库符号正常展示、仅libc/libart/libbase/libandroid_runtime这类系统库无符号，本质原因是你当前的Crashlytics配置只会上传自己构建的原生库符号，服务端默认没有全量Android系统库的符号表，自然无法解析对应堆栈。本地Android Studio能看到完整符号，是因为调试时连接的设备本地自带对应系统版本的符号，Crashlytics后台拿不到这些设备专属的系统库符号。

• 第一步：先确认崩溃上报携带了系统库的BuildId
  你本地抓到的日志里每个系统库条目都带类似BuildId: adb75d6f792faa24b1bc8cf512fb112c的字段，先去Crashlytics的原始崩溃详情页检查，上报的堆栈里是否包含这些BuildId。如果上报逻辑被定制过、丢了BuildId字段，就算传了符号也无法匹配。如果自己改过NDK崩溃拦截逻辑，先恢复默认上报逻辑，确保所有加载的so（包括系统库）的BuildId都随崩溃上报。
• 第二步：收集匹配版本的未剥离系统库
  系统库必须和崩溃发生设备的系统版本、Build号完全对应，差一个小版本pc偏移就会完全错位，解析结果无效：
  • 官方Pixel设备可直接下载对应Build号的工厂镜像，解压后从symbols目录下找对应架构的未剥离系统库，注意Android 10及以上版本libart.so等库在com.android.art等apex分区的对应目录下，别拿/system下的旧版本凑数。
  • 其他厂商设备需要找官方发布的对应版本原生符号包，普通user版设备里的系统库本身是剥离过符号的，直接从设备里pull出来没用。
• 第三步：将收集到的系统库放入符号上传目录
  把对应架构的未剥离系统库，放到你配置的unstrippedNativeLibsDir路径下，按架构分子目录存放，和你自己的原生库目录结构保持一致，比如arm64位的系统库放到PATH/TO/UNSTRIPPED/DIRECTORY/arm64-v8a/下。
• 第四步：重新执行符号上传任务
  构建完应用后，执行对应构建变体的Crashlytics符号上传任务，比如release版本执行./gradlew app:uploadCrashlyticsSymbolFileRelease，确保包含系统库在内的所有符号都上传到后台，新触发的崩溃就能正常解析系统库符号了。

• 受安卓碎片化影响，你不可能收集全所有厂商、所有版本的系统库符号，这个方案只能覆盖你提前准备了符号包的设备/系统版本，没法做到全量用户的系统堆栈都解析。
• 如果是本地复现的调试类崩溃，没必要非在Crashlytics里看符号，直接用SDK自带的ndk-stack工具，搭配对应设备的系统符号，本地就能直接把Crashlytics导出的原始偏移堆栈解析成带函数名的完整堆栈，效率更高。
• 绝对不要用版本不匹配的系统库解析堆栈，解析出来的错误函数名会完全误导调试方向，使用前务必核对库的BuildId和崩溃上报里的BuildId完全一致。

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