Linux下QT程序崩溃日志自动记录方案

1. 项目概述与背景

在Linux环境下开发QT后台程序时，程序崩溃是开发者经常遇到的问题。传统的调试方式往往需要附加gdb或者查看系统日志，这在生产环境中既不高效也不实用。本文将介绍一种在QT程序中实现崩溃日志自动记录的方法，通过捕获信号、解析调用栈并输出到日志文件，帮助开发者快速定位问题。

这个方案的核心优势在于：

• 完全自动化：崩溃发生时自动触发，无需人工干预
• 信息完整：包含时间戳、信号类型、调用栈等关键信息
• 生产环境友好：不依赖调试器，直接输出到日志文件
• 地址解析：能将内存地址转换为函数名和行号

2. 核心实现原理

2.1 信号处理机制

Linux系统通过信号机制通知进程发生的异常情况。常见的崩溃信号包括：

• SIGSEGV：段错误（非法内存访问）
• SIGABRT：程序主动中止
• SIGFPE：浮点异常
• SIGILL：非法指令

我们的方案通过signal()函数注册这些信号的自定义处理函数，替代系统默认行为。

2.2 调用栈捕获

backtrace()系列函数是GNU扩展，可以获取当前线程的函数调用栈。关键函数：

• backtrace()：获取调用栈地址数组
• backtrace_symbols()：将地址转换为可读字符串（但我们不使用这个，因为它无法解析行号）

2.3 地址到源码的转换

addr2line工具是GNU Binutils的一部分，可以根据地址和调试信息定位到源码位置。我们需要：

1. 计算正确的地址偏移量
2. 通过fork()+exec()调用addr2line
3. 解析其输出结果

3. 代码实现详解

3.1 头文件定义（CrashLog.h）

cpp复制#ifndef CRASHLOG_H
#define CRASHLOG_H

#include <QObject>
#include <QFileInfo>
#include <QDateTime>
#define __USE_GNU  // 启用GNU扩展，暴露Elf64_Ehdr/Elf64_Phdr等结构体
#include <elf.h>
#include <csignal>
#include <cstdio>
#include <cstdlib>
#include <cstring>
#include <unistd.h>
#include <fcntl.h>
#include <sys/stat.h>
#include <sys/wait.h>
#include <execinfo.h>
#include <errno.h>

// 配置项（根据你的环境调整）
#define CRASH_LOG_PATH "/tmp/ReportConfig_crash.log"  // 无需root权限，避免权限问题
#define ADDR2LINE_PATH "/usr/bin/addr2line"           // addr2line路径
#define MAPS_BUF_SIZE 16384                           // 增大maps缓冲区

class CrashLog : public QObject
{
    Q_OBJECT
public:
    explicit CrashLog(QObject *parent = nullptr);
    void initProgramInfo();               // 初始化程序信息
    void registerCrashHandler();          // 注册崩溃信号处理器
    
private:
    static uint64_t getElfTextBase(const char* exePath);  // 获取ELF.text段基址
    static void resolveCrashAddr(void* addr, int logFd);  // 解析崩溃地址
    static void crashSignalHandler(int sig);              // 信号处理函数
    
private:
    static uint64_t g_programBaseAddr;    // 程序加载基址
    static char g_realExePath[1024];      // 程序真实路径
};
#endif // CRASHLOG_H

3.2 核心实现（CrashLog.cpp）

3.2.1 ELF文件解析

cpp复制uint64_t CrashLog::getElfTextBase(const char *exePath) {
    int fd = open(exePath, O_RDONLY);
    if (fd < 0) {
        fprintf(stderr, "打开文件失败：%s\n", strerror(errno));
        return 0;
    }

    // 读取E