macOS环境下如何为Apache AGE挂载gdb调试器

第一步：解决gdb未找到的问题 #

1. 安装gdb #

macOS默认不预装gdb，通过Homebrew安装是最便捷的方式：

brew install gdb

2. 为gdb进行代码签名（关键步骤） #

macOS的安全机制要求调试器必须经过代码签名才能正常工作，否则会无法附加进程或启动调试：

• 打开「钥匙串访问」应用，点击菜单栏的「钥匙串访问」>「证书助理」>「创建证书」
• 填写信息：
  • 名称：比如gdb-cert
  • 身份类型：自签名根证书
  • 证书类型：代码签名
  • 勾选「让我覆盖这些默认值」，一路点击继续直到完成
• 在钥匙串中找到刚创建的证书，右键点击>「显示简介」>「信任」，将「代码签名」设置为「始终信任」
• 重启你的Mac（必要步骤，让签名生效）
• 终端中执行命令为gdb签名：

codesign -fs gdb-cert /usr/local/bin/gdb

3. 配置gdb避免启动错误 #

创建或编辑~/.gdbinit文件，添加以下内容：

set startup-with-shell off

这可以解决gdb在macOS上启动时可能出现的shell相关错误。

第二步：挂载gdb调试Apache AGE #

Apache AGE是PostgreSQL的扩展，调试时需要结合PostgreSQL的调试流程：

1. 带调试符号编译PostgreSQL和Apache AGE #

确保你在编译PostgreSQL和AGE时启用了调试符号，这样gdb才能正确识别代码：

• 编译PostgreSQL时添加--enable-debug参数：

./configure --enable-debug [其他你的配置参数]
make && make install

• 编译Apache AGE时，需在带调试符号的PostgreSQL环境下编译（默认若PostgreSQL为debug模式，AGE编译也会自动保留调试符号）

2. 方式一：用gdb启动PostgreSQL并调试AGE #

• 切换到PostgreSQL的数据目录（比如/usr/local/var/postgres）
• 用gdb启动postgres进程：

gdb /usr/local/bin/postgres

• 在gdb中设置断点到AGE的函数，比如创建图的函数：

b age_create_graph

• 启动postgres进程：

run -D /usr/local/var/postgres

• 另开一个终端连接到PostgreSQL，执行触发断点的SQL（比如SELECT create_graph('my_graph');），此时gdb会触发断点，你可以进行查看变量、单步执行等调试操作

3. 方式二：附加到运行中的PostgreSQL进程 #

如果PostgreSQL已经在运行，可以直接附加进程：

• 先找到postgres的进程ID（PID）：

pgrep postgres

• 用gdb附加到该进程：

gdb -p [PID]

• 设置断点到AGE的相关函数，执行对应的SQL触发断点即可调试

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