OSX Xcode中程序加载库失败，如何定位故障库？

针对你遇到的Dyld加载错误（找不到/usr/local/lib/liblibdbwindow.dylib，但Bundle的Frameworks目录存在该库），可以通过以下步骤定位问题：

• 检查库的安装路径（Install Name）
  用otool命令查看主程序和嵌入库的路径配置：

  • 查看主可执行文件的依赖列表：

    otool -L /path/to/dbhandler.app/Contents/MacOS/dbhandler
    

    重点看liblibdbwindow.dylib对应的路径，如果显示的是/usr/local/lib/liblibdbwindow.dylib，说明主程序硬编码了系统路径，而非指向Bundle内部的库。
  • 查看Frameworks目录中库自身的安装名：

    otool -L /path/to/dbhandler.app/Contents/Frameworks/liblibdbwindow.dylib
    

    正常应该是@rpath/liblibdbwindow.dylib这类相对路径。

• 验证@rpath配置
  检查主程序的运行时搜索路径（rpath）是否包含Bundle的Frameworks目录：

  otool -l /path/to/dbhandler.app/Contents/MacOS/dbhandler | grep -A 5 -B 2 LC_RPATH
  

  输出中需要存在@executable_path/../Frameworks（表示从主程序所在目录向上一级再进入Frameworks），否则dyld找不到内部库。

• 开启Dyld调试日志追踪加载过程
  运行应用时开启Dyld的日志输出，直观看到加载库的路径尝试顺序：

  DYLD_PRINT_LIBRARIES=1 open dbhandler.app
  

  日志会显示Dyld尝试加载每个库的具体路径，能明确它为什么优先去/usr/local/lib而非内部Frameworks。

• 检查Xcode构建设置
  回到Xcode项目，确认以下配置：

  • Runpath Search Paths：需包含@executable_path/../Frameworks
  • 嵌入库的Install Name：应设置为@rpath/liblibdbwindow.dylib，而非绝对路径

• 验证代码签名（若应用需要签名）
  如果应用启用了代码签名，检查签名是否匹配：

  codesign --verify --verbose /path/to/dbhandler.app
  

  路径不匹配的库会导致签名验证失败，进而触发加载错误。

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