如何调试ObjC运行时同一动态库多实例的链接冲突问题

1. 排查依赖库的递归引用 #

这是该场景下最常见的诱因，主二进制的链接依赖正常不代表其依赖的第三方库没有链接全局版本的libSDL2

• 检查你项目依赖的所有外部动态库的链接情况，首当其冲的就是你用到的libSDL2_image，执行命令：
  otool -L /Users/<my-project>/Libraries/SDL-install/lib/libSDL2_image-2.0.0.dylib
  如果输出中出现/opt/local/lib/libSDL2-2.0.0.dylib，说明你编译自定义SDL_image时未指定链接你本地修改过的SDL2，编译脚本自动找到了全局的MacPorts版本，导致两个SDL2被同时加载。解决方法是重新编译SDL_image，编译时指定PKG_CONFIG_PATH为你本地SDL的pkgconfig路径，强制链接自定义版本。

2. 检查dyld运行时搜索路径优先级 #

macOS的动态链接器dyld加载库时会按预设的路径顺序搜索匹配的库文件，如果全局路径优先级高于你自定义SDL的路径，也会触发冲突：

• 启动应用前先执行export DYLD_PRINT_LIBRARIES=1，再运行你的应用，控制台会输出所有动态库的加载路径和顺序，可以直接定位到是哪一步加载了/opt/local下的libSDL2。
• 检查当前环境的动态库搜索变量，执行echo $DYLD_LIBRARY_PATH $DYLD_FALLBACK_LIBRARY_PATH，如果输出中包含/opt/local/lib，可以在运行应用前临时调整路径优先级，把自定义SDL的库路径放在最前面：
  export DYLD_LIBRARY_PATH=/Users/<my-project>/Libraries/SDL-install/lib:$DYLD_LIBRARY_PATH

3. 校验自定义SDL的install name配置 #

你编译自定义SDL2时如果没有正确设置install name，dyld可能会按默认的标识路径去全局位置查找库：

• 查看自定义SDL的install name：otool -D /Users/<my-project>/Libraries/SDL-install/lib/libSDL2-2.0.0.dylib
• 如果输出不是你本地的SDL库绝对路径，可以用install_name_tool修改：
  install_name_tool -id /Users/<my-project>/Libraries/SDL-install/lib/libSDL2-2.0.0.dylib /Users/<my-project>/Libraries/SDL-install/lib/libSDL2-2.0.0.dylib

4. 规避方案：静态链接自定义SDL2 #

如果不想处理动态库加载冲突，可以直接编译SDL2为静态库（编译时加--enable-static --disable-shared参数），项目直接链接静态版的SDL2，完全规避动态库加载冲突问题。

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