如何让GDB线程列表优先显示本地文件栈帧以快速定位C++死锁

原生GDB的info threads默认显示线程最顶层的栈帧，刚好对应你遇到的库函数锁等待逻辑，你可以通过自定义GDB命令实现优先展示本地代码栈帧的需求，以下是三种不同复杂度的实现方案：

方案1：临时自定义命令（单次调试用） #

直接在GDB交互界面输入以下内容，就能快速生成专用查询命令：

define info-threads-local
  thread apply all bt 10 | grep -E "(Thread|\.(c|cpp|cc|cxx):)" | grep -vE "(/usr/|/lib/|pthread_|lowlevellock)"
end
document info-threads-local
输出所有线程中第一个匹配本地C/C++源文件的栈帧，自动跳过系统库层
end

使用时直接执行info-threads-local即可，输出效果如下：

Thread 0x7ffff7a40700 (LWP 2651293) "main.exe":
#4  0x0000000000401223 in lock_a () at main.cpp:8
Thread 0x7ffff7a41740 (LWP 2651239) "main.exe":
#1  0x000000000040127b in main () at main.cpp:14

如果栈深度超过10层，把命令里的bt 10改成更大的数值即可。

方案2：永久配置到.gdbinit #

如果想一劳永逸，把以下配置写入你用户目录的~/.gdbinit文件，之后每次启动GDB执行info threads时，都会先输出所有线程的本地代码栈帧：

define hook-info-threads
  echo === 线程本地代码栈帧 ===\n
  thread apply all bt 20 | grep -E "(Thread |at .*\\.(c|cpp|cc|cxx):)" | grep -vE "(/usr/|/lib/|pthread_|lowlevellock|no such file)"
  echo \n=== 原生info threads输出 ===\n
end

方案3：Python精准过滤（复杂项目适用） #

如果你的项目源文件分布在自定义目录，需要更精准的过滤规则，可以用GDB Python API实现自定义命令，把以下代码存为~/.gdb/local_thread_frames.py：

import gdb

class InfoThreadsLocal(gdb.Command):
    def __init__(self):
        super().__init__("info-threads-local", gdb.COMMAND_USER)
    
    def invoke(self, arg, from_tty):
        inf = gdb.selected_inferior()
        if not inf.threads():
            print("无运行中的线程")
            return
        for thread in inf.threads():
            thread.switch()
            frame = gdb.newest_frame()
            local_frame = None
            # 遍历栈帧找第一个非系统路径的帧
            while frame:
                sal = frame.find_sal()
                if sal.symtab:
                    fpath = sal.symtab.filename
                    # 可自行修改过滤规则，匹配你的项目源码路径
                    if not fpath.startswith(("/usr/", "/lib/", "/build/")):
                        local_frame = (frame.level, frame.name(), fpath, sal.line)
                        break
                frame = frame.older()
            # 打印结果
            print(f"线程ID {thread.num} (TID {thread.ptid[2]}):")
            if local_frame:
                lvl, func, fpath, line = local_frame
                print(f"  #{lvl} {func}() at {fpath}:{line}")
            else:
                print(f"  无匹配的本地代码帧，顶层帧：{gdb.newest_frame().name()}")

InfoThreadsLocal()

然后在~/.gdbinit中添加一行source ~/.gdb/local_thread_frames.py，之后启动GDB执行info-threads-local即可得到精准的过滤结果。

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