最近這段時間,無論是開發除錯階段還是應用上線之後,App 崩潰的狀況都沒停過。單純的崩潰還好處理,複雜的就得靠解析 Crash 檔來抽絲剝繭。這在 iOS 開發中算是日常功課,但和不少開發者聊下來發現,大家對符號表這塊其實還有些模糊。
網路上關於堆疊符號化的文章很多,品質卻參差不齊,有些關鍵細節也沒交代清楚。今天就把 iOS 崩潰符號化的用法與實作原理完整梳理一遍。
我們收集到的崩潰堆疊,通常長得像這樣,整片都是十六進位的記憶體位址:
這種格式很難直接判讀,更別提定位到出問題的程式碼。只有把它轉成人看得懂的形式才有意義:
如圖所示,一眼就能看出這次崩潰發生在 ViewController.m 的第 68 行,對應的方法是 rangeException。那這個轉換是怎麼做到的呢?
用 Xcode 開發除錯時,遇到崩潰可以直接靠除錯器定位。但 App 一旦發布,使用者手機上的崩潰就只能透過系統留下的崩潰日誌來追查。而這份日誌裡記錄的,是 App 出錯時的函式記憶體位址,長得像 0x2312e92f 這樣,光看就令人頭痛。
幸好還有 dSYM 檔。它是把苦哈哈的位址還原成有意義資訊的關鍵:有了它,堆疊裡的函式位址就能對應出檔案名、函式名與行號。事實上,你在 Xcode Organizer 裡看到的可讀堆疊,背後就是它在拿本機的 .dSYM 做符號化。
這是一支把堆疊位址符號化的腳本,輸入參數是蘋果官方格式的崩潰日誌加上本機的 .dSYM 檔。
執行方式:symbolicatecrash + 崩潰日誌 + 對應的 .dSYM 檔 > 輸出檔案。
但它限制不少:
(1)只能吃官方格式的崩潰日誌,得從具體裝置導出,取得與操作都不方便;
(2)符號化結果往往不含行號資訊,而且失敗的機率不低。
順帶一提,Xcode Organizer 內部其實就打包了這個工具,這也是為什麼你能在 Organizer 直接看到符號化後的堆疊。
更常見的情況是你手上只有一段錯誤堆疊文字,這時就用 atos 把位址換回函式與行號。
執行方式:
atos -o executable -arch architecture -l loadAddress address
參數說明:
loadAddress 是函式的動態載入位址,對應崩潰堆疊中「+」號前面的那個位址,例如 0x00048000。
address 是執行期位址,對應堆疊中的第一個位址,例如 0x0004fbed。實際上把「+」號前後兩個值相加就是執行期位址,也就是 0x00048000 + 31720 = 0x0004fbed。
查詢後可以看到類似這樣的結果:
-[ViewController rangeException:] (in xx)(ViewController.m:68)
如果想自己實作符號化,需要分別處理兩類符號:使用者符號與系統符號。
依據來自 dSYM 檔。dSYM 本身也是 Mach-O 格式,照著 Mach-O 的結構逐段解析即可。
從上圖大致可以看出,Mach-O 可以分成三個部分:
(1)Header
(2)Segment
(3)Section
也就是 header 之後接 segment,再接 section,而一個 segment 內部可以包含多個 section。
把 dSYM 丟進十六進位檢視工具來看:
這個 dSYM 裡同時有 armv7 與 arm64 兩套架構的符號表。我們只看 armv7(arm64 同理),它偏移 64,直接跳到 0x00000040,這裡就是 Mach Header 的資訊。
跟符號表相關的有兩處:一是 LC_SYMTAB,二是 LC_SEGMENT(__DWARF) 底下的 Section Header(__debug_line)。
LC_SYMTAB 資訊
定位方式:偏移 4096 + 64(0x1040),就能找到函式符號區塊 Symbols。把符號解析出來後,例如第一個函式 -[DKDLicenseAgreeementModel isAuthorize],對應的記憶體位址就是模組位址加上 43856。
__debug_line 區塊
這裡存放的是程式碼行號資訊,需要依 DWARF 格式逐筆解析。先定位到 segment:LC_SEGMENT(__DWARF),再定位到 section:__debug_line。
它的偏移值是 4248608,4248608 + 64 = 0x40D460,即可定位到 Section(__DWARF, __debug_line),裡面就是具體的行號資料。
解析出來的結果如下:
第一欄是起始記憶體位址,第二欄是結束位址,第三欄是對應的函式名、檔案名與行號。有了這份對照表,之後捕到任何崩潰資訊都能輕鬆還原。
上面這套流程處理 Objective-C 符號沒問題,但遇到 C++ 或 Swift 就得額外加工,因為這兩種語言都會做「名稱重整」(name mangling)。
Swift 符號:Swift 函式經過名稱重整,直接從 dSYM 解析出來的原始符號並不直覺。
用 swift-demangle 還原:
swift-demangle –simplified originName
C++ 符號:同樣會被重整,原始符號如下:
用 c++filt 還原:
c++filt originName
未解析形式:
解析後:
Apple 並沒有提供系統庫符號表的下載入口,只能透過真機取得。當你把開發機連上 Mac,Xcode 會先把該機型的符號複製到電腦裡。
「Processing symbol files」做的就是這件事,存放路徑是:
~/Library/Developer/Xcode/iOS DeviceSupport
這種做法有個明顯缺陷:你手上的真機 iOS 版本數量有限,不可能涵蓋所有版本,系統符號勢必有缺。另一條路是下載各種 iOS 韌體,直接從韌體裡解析符號。
實際專案開發中,崩潰的定位分析很少走這條路。原因是它高度依賴系統記錄的崩潰日誌或錯誤堆疊——本地開發除錯階段還算好用,但線上版本出問題時,開發者根本拿不到即時準確的堆疊。
因此一般團隊都會接入第三方崩潰監控服務(例如網易雲捕),由 SDK 在崩潰現場把堆疊與上下文捕下來,再於後台完成符號化與聚合統計,才能支撐線上問題的記錄與追蹤。理解本文的原理,恰好能幫助你看懂這些服務背後做了什麼。