如何让Rust函数名显示在Linux backtrace(3)输出中？

首先得给你点个赞，你已经做了不少正确的尝试：加了 -rdynamic、开了调试信息、禁用了符号剥离、甚至强制开启了帧指针，但还是没看到Rust函数名——这大概率是Rust对cdylib默认的符号可见性规则在搞鬼，再结合LTO优化的影响，咱们一步步来排查解决：

核心问题：Rust函数的符号默认是“隐藏”的 #

Rust为了cdylib的安全性和体积，默认会把非extern "C"的Rust函数符号设置为hidden，这就相当于C语言里的static函数——动态链接器根本看不到这些符号，backtrace(3)自然也没法解析出函数名。你能看到那个唯一的函数名，正是因为它加了#[no_mangle]和extern "C"，强制把符号改成了全局可见。

接下来给你几个具体的解决方向，你可以按顺序尝试：

1. 全局开放符号可见性（调试阶段首选） #

如果只是为了调试回溯，不想一个个改函数属性，可以直接让所有Rust函数符号默认可见。修改你的.cargo/config.toml或者编译时加RUSTFLAGS：

# .cargo/config.toml 里的配置
[target.'cfg(target_os = "linux")']
rustflags = [
  "-C", "symbol-visibility=default",  # 全局设置符号可见性为默认（全局可见）
  "-C", "link-arg=-rdynamic",
  "-C", "force-frame-pointers=yes"
]

然后重新编译：

cargo zigbuild --release --target x86_64-unknown-linux-gnu.2.12

⚠️ 注意：这么做会让你的库导出所有内部函数符号，体积会变大，也会暴露内部实现，适合调试用，上线前记得改回去。

2. 给特定函数单独开放可见性 #

如果不想全局导出符号，可以给需要在回溯中显示的函数单独加属性：

• 如果你能接受去掉Rust的名字修饰，直接用#[no_mangle]：

#[no_mangle]
pub fn my_critical_rust_function() {
  // 函数逻辑
}

• 如果你想保留Rust的名字修饰（避免符号冲突），用Rust 1.59+支持的#[symbol_visibility("default")]：

#[symbol_visibility("default")]
pub fn my_critical_rust_function() {
  // 函数逻辑
}

这样这个函数的符号会被导出，backtrace(3)能识别到它，同时保留Rust的命名空间修饰。

3. 排查LTO优化的影响 #

你当前开了lto = true，链接时优化（LTO）会做很多激进操作：内联函数、合并符号、甚至删掉没被直接引用的函数——这也会导致回溯里看不到函数名。

可以先临时关闭LTO验证一下，修改Cargo.toml：

[profile.release]
lto = false  # 临时关闭LTO
debug = true
strip = false
split-debuginfo = "packed"
panic = "unwind"

如果关闭后函数名能显示了，那就是LTO的锅。这时候你可以给关键函数加#[inline(never)]阻止内联，或者改成lto = "thin"（轻量LTO），在优化和符号保留之间找平衡。

4. 先验证符号是否真的被导出 #

不管用哪种方案，都可以用工具先确认符号是否真的被导出了，避免做无用功：
用readelf查看动态符号表：

readelf -sW your_cdylib.so | grep "my_critical_rust_function"

如果输出里能看到这个函数，并且BIND列是GLOBAL，说明符号导出成功；如果看不到或者BIND是LOCAL，那还得调整编译配置。

也可以用nm工具快速检查：

nm -D your_cdylib.so | grep "my_critical_rust_function"

能看到大写T开头的行（表示文本段的全局函数）就没问题。

5. 针对cargo zigbuild的特殊检查 #

因为你用的是cargo zigbuild，要确认zig的链接器是否正确传递了参数。用-vv参数看编译详情：

cargo zigbuild -vv --release --target x86_64-unknown-linux-gnu.2.12

检查rustc调用里是否包含：

• -C symbol-visibility=default
• -C link-arg=-rdynamic
• -C force-frame-pointers=yes
  如果参数都在但还是不行，可以试试把-rdynamic换成更明确的链接器参数：-C link-arg=-Wl,--export-dynamic，有时候zig链接器对-rdynamic的处理和GCC链接器略有不同。

最后再提一句，backtrace(3)本身依赖动态符号表，如果你已经有调试信息，也可以用addr2line直接解析地址：

addr2line -e your_cdylib.so 0x256d0a

如果这个命令能输出正确的函数名，说明调试信息是好的，只是动态符号表没导出而已。

内容来源于stack exchange