M3 Pro Sonoma 14.4下VSCode Rust调试器libmysqlclient.20.dylib加载失败

问题根源 #

正常运行时系统能通过/usr/local/lib找到libmysqlclient.20.dylib，但CodeLLDB调试时的环境不加载默认系统库路径，加上你的Rust二进制文件本身没有配置LC_RPATH（动态库搜索路径），导致调试器找不到依赖库。另外Sonoma 14.4对Apple Silicon机器的动态库加载逻辑有调整，进一步放大了这个问题。

修复步骤 #

1. 确认二进制文件的RPATH配置

打开终端，执行以下命令查看目标程序的RPATH设置：

otool -l /Users/hoppmann/Documents/GitHub/EazyFindings2/EazyFindings/target/debug/deps/Logic-4978c930827444e3 | grep -A 5 LC_RPATH

如果没有输出，说明程序确实未配置任何RPATH，这是调试失败的核心原因。

2. 编译时强制添加RPATH

在编译Rust项目时，通过RUSTFLAGS指定链接参数，将/usr/local/lib加入RPATH：

RUSTFLAGS="-C link-arg=-Wl,-rpath,/usr/local/lib" cargo build

这样编译出的二进制文件会自带RPATH配置，调试器可直接定位到依赖库。

3. 直接修改已编译的二进制文件（临时方案）

若不想重新编译，可使用install_name_tool为现有二进制文件添加RPATH：

install_name_tool -add_rpath /usr/local/lib /Users/hoppmann/Documents/GitHub/EazyFindings2/EazyFindings/target/debug/deps/Logic-4978c930827444e3

执行完成后重新启动CodeLLDB调试即可。

4. 检查libmysqlclient的架构兼容性

M3 Pro为arm64架构，需确保安装的libmysqlclient.20.dylib是原生arm64版本（x86_64版本通过Rosetta运行可能存在路径识别问题）。执行以下命令查看架构：

file /usr/local/lib/libmysqlclient.20.dylib

若输出仅包含x86_64，卸载现有版本后重新安装arm64版本的MySQL客户端（比如通过Homebrew安装时添加--build-from-source参数确认架构）。

5. 调整CodeLLDB的调试环境（备选）

若上述方法无效，可在VSCode的launch.json中添加环境变量，强制调试器加载指定库路径：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "lldb",
            "request": "launch",
            "name": "Debug Logic",
            "program": "${workspaceFolder}/target/debug/deps/Logic-4978c930827444e3",
            "env": {
                "DYLD_LIBRARY_PATH": "/usr/local/lib"
            }
        }
    ]
}

注意：Sonoma系统对DYLD_LIBRARY_PATH有安全限制，此方法可能在部分场景下无效，优先尝试前面的RPATH配置方案。

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