在嵌入式Linux開發中，特別是復雜軟件，多人協作開發時，當某人無意間寫了一個代碼bug導致程序崩潰，但又不知道崩潰的具體位置時，單純靠走讀代碼，很難快速的定位問題。

本篇就來介紹一種方法，使用backtrace工具，來輔助定位程序崩潰的位置信息。

backtrace是 C/C++ 中用于獲取程序調用棧信息的函數，借助backtrace可以排查崩潰并定位代碼行號。

1.backtrace分析程序崩潰的原理

在linux系統中，運行程序若發生崩潰，會產生相應的信號，例如訪問空指針會觸發SIGSEGV（signum：11）。

這時可以使用signal函數來捕獲這個信息，捕獲信號后，支持自定義的handler函數進行一些處理。

在自定義的handler函數中，可以使用backtrace函數，來打印程序調用棧信息。

最后使用addr2line函數，將地址轉換為可讀的函數名和行號。

使用backtrace分析程序崩潰，需要在編譯時使用 -g 選項生成的調試信息。

使用addr2line工具，將地址轉換為可讀的函數名和行號，實例如下：

addr2line -e 程序名 -f -C 0x400526
# 輸出：
main
/path/to/main.c:42

2.一些要用到的函數

2.1 signal

2.1.1 函數原型

在 C 和 C++ 中，signal 函數用于設置信號處理方式。

其原型定義在 <signal.h> 頭文件中：

typedef void (*sighandler_t)(int);

sighandler_t signal(int signum, sighandler_t handler);

參數說明：

• int signum：信號編號（整數），如：

SIGINT（2）：中斷信號（Ctrl+C）

SIGSEGV（11）：段錯誤

SIGILL（4）：非法指令

SIGTERM（15）：終止信號

SIGFPE（8）：浮點異常

• sighandler_t handler：信號處理函數指針，有三種取值：
• 用戶定義函數：void handler(int signum) 類型的函數
• SIG_DFL：默認處理（如終止程序）
• SIG_IGN：忽略該信號

返回值：

• 成功：返回之前的信號處理函數指針
• 失敗：返回 SIG_ERR，并設置 errno（如 EINVAL 表示無效信號）

2.1.2 常見信號列表

信號分類：

• 不可捕獲信號：無法通過signal或sigaction修改處理方式，只能由系統強制控制。

SIGKILL（9）

SIGSTOP（19）

• 用戶自定義信號：可由程序自由定義處理邏輯，常用于進程間通信或調試。

SIGUSR1（10）

SIGUSR2（12）

• 異常信號：通常由程序錯誤（如內存操作異常）觸發，默認會生成 Core 文件用于調試。

SIGBUS（7）

SIGSEGV（11）

• ...

默認行為的差異：

• 多數信號的默認行為是終止程序，但部分信號（如SIGCHLD）默認會被忽略，而SIGCONT則用于恢復進程運行。

2.2 backtrace

在 C 和 C++ 中，backtrace 函數用于獲取當前程序的調用堆棧信息，常用于調試和錯誤處理。

其原型定義在 <execinfo.h> 頭文件中：

/* 獲取當前調用堆棧中的函數地址 */
int backtrace(void **buffer, int size);

• 參數

void **buffer：指向存儲函數地址的數組的指針。

int size：數組的最大元素數（即最多獲取的堆棧幀數）。

• 返回值

成功：返回實際獲取的堆棧幀數（不超過 size）。

失?。悍祷?0（極罕見，通常僅在內存不足時發生）。

2.3 backtrace_symbols

/* 將函數地址轉換為可讀的字符串（如函數名、偏移量） */
char **backtrace_symbols(void *const *buffer, int size);

• 參數

void *const *buffer：backtrace返回的函數地址數組

int size：backtrace返回的實際幀數

• 返回值

成功：返回指向字符串數組的指針，每個元素對應一個堆棧幀（需用 free() 釋放）

失?。悍祷?nbsp;NULL，并設置 errno

2.4 backtrace_symbols_fd

/* 將函數地址直接輸出到文件 */
void backtrace_symbols_fd(void *const *buffer, int size, int fd);

• 參數

void *const *buffer：同 backtrace_symbols

int size：同 backtrace_symbols

int fd：文件描述符（如 STDERR_FILENO），用于輸出結果

• 返回值：無（直接輸出到文件）

3.實例代碼

3.1 主函數

//g++ -g test.cpp -o test
#include <execinfo.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <csignal>
#include <string.h>
#include <fcntl.h>
#include <vector>

//<---信號處理函數添加到這里

void TestFun()
{
    printf("[%s] in\n", __func__);
std::vector<int> a;
printf("[%s] a[1]=%d\n", __func__, a[1]);
}

int main()
{
    std::vector<int> vSignalType = {SIGILL, SIGSEGV, SIGABRT};                             
    for (int &signalType : vSignalType)
    {
        if (SIG_ERR == signal(signalType, SignalHandler))
        {
            printf("[%s] signal for signalType:%d err\n", __func__, signalType);
        }
    }

 TestFun();
return0;
}

3.2 信號處理函數

#define MAX_STACK_FRAMES 100

void SignalHandler(int signum)
{
    printf("[%s] signum:%d(%s)\n", __func__, signum, strsignal(signum));
    signal(signum, SIG_DFL); //恢復默認行為

    // [backtrace] 獲取當前調用堆棧中的函數地址
    void *buffer[MAX_STACK_FRAMES];
    size_t size = backtrace(buffer, MAX_STACK_FRAMES);
    printf("[%s] backtrace() return %zu address. Stack trace:\n", __func__, size);
    
    // [backtrace_symbols] 將函數地址轉換為可讀的字符串
    char **symbols = (char **) backtrace_symbols(buffer, size);
    if (symbols == NULL) 
    {
        printf("[%s] backtrace_symbols() null\n", __func__);
        return;
    }

    for (size_t i = 0; i < size; ++i)
    {
        printf("#%d %s\n", (int)i, symbols[i]); //打印每一個函數地址
    }
    free(symbols);
    
    // [backtrace_symbols_fd] 將函數地址直接輸出到文件
    int fd = open("backtrace.txt", O_CREAT | O_WRONLY, S_IRWXU | S_IRWXG | S_IRWXO);
    if (fd >= 0)
    {
        backtrace_symbols_fd(buffer, size, fd);
        close(fd);
    }
}

3.3 addr2line解析backtrace信息

#!/bin/sh

if [ $# -lt 2 ]; then
echo"example: myaddr2line.sh test backtrace.log"
exit 1
fi

BIN_FILE=$1
BACK_TRACE_FILE=$2

lines=$(cat $BACK_TRACE_FILE | grep ${BIN_FILE})
for line in${lines}; do
 addr=$(echo$line | awk -F '(''{print $2}' | awk -F ')''{print $1}')
 addr2line -e ${BIN_FILE} -C -f $addr
done

addr2line 是一個用于將程序地址（如內存地址）轉換為源代碼位置（文件名和行號）的工具。以下是其常用參數的詳細含義：

3.4 測試結果

圖片

可以看到，定位到了test.cpp的50行為崩潰的位置，代碼中的vector a沒有賦值，直接訪問vector[1]將會崩潰。

具體的調用棧關系為：

• main函數，test.cpp的65行：調用的TestFun函數
• TestFun函數，test.cpp的50行：執行的printf("[%s] a[1]=%d\n", __func__, a[1]);
• SignalHandler函數，test.cpp的20行：崩潰觸發的SIGSEGV信號被捕獲后，在SignalHandler函數中的backtrace被處理

SignalHandler函數中，通過backtrace_symbols打印的信息，與通過backtrace_symbols_fd保存在backtrace.txt文件中的信息，其實是一樣的：

圖片

使用myaddr2line.sh腳本，可以方便打印所有的行號信息。

當然也可以手動使用addr2line來打印行號信息，只是效率較低。

另外，注意backtrace的地址，圓括號 () 和 方括號 [] 中的地址具有不同含義，分別對應 符號表中的函數地址 和 實際執行地址。

• 圓括號 (...) 中的地址

含義：函數內部的 相對偏移量（相對于函數起始地址）

格式：函數名+0x偏移量

作用：指示崩潰發生在該函數的具體位置。

• 方括號 [...] 中的地址

含義：指令在 內存中的實際地址（絕對地址）

格式：0xXXXXXXXX

作用：可直接用于 addr2line 等工具定位源代碼

但在本示例程序測試中，卻要使用圓括號中的地址，addr2line才能顯示行號，這里有待再研究。

圖片

4.總結

本篇介紹了如何使用backtrace工具來定位Linux應用程序崩潰的位置信息，首先通過signal捕獲崩潰信息，然后通過backtrace記錄崩潰時的堆棧調用信息，最后使用addr2line來顯示對應的崩潰時的代碼行號。