共享库依赖未在ldd中列出，链接可执行文件遇未定义符号错误

你遇到的情况很典型：libxxxx.so编译时明明指定了-lyaml，但ldd和readelf都显示它只依赖libc.so.6，而nm却能看到一堆yaml相关的未定义符号；依赖它的libxxxx1.so在链接可执行文件时，就会因为找不到这些符号报错。

这问题我碰到过好几次，核心原因是你的libxxxx.so没有将libyaml.so标记为必需依赖项（也就是readelf -d输出里的NEEDED条目），导致依赖链上层的库和可执行文件无法自动找到yaml的符号。

下面是几种可行的解决方法，按推荐优先级排序：

1. 重新编译修复libxxxx.so（最优方案） #

这是最根本的解决办法，确保libxxxx.so正确声明它的依赖：

• 检查libxxxx.so的编译链接命令，确保-lyaml放在所有目标文件和其他依赖库的后面。比如正确的链接命令应该是：

  gcc -shared -o libxxxx.so foo.o bar.o baz.o -lyaml
  

  链接器是按顺序处理输入的，如果-lyaml放在目标文件前面，链接器可能无法识别到它被依赖，从而不会将其加入NEEDED列表。
• 如果你用的是autoconf工具链，可以在Makefile.am中为目标库的LDFLAGS添加-lyaml，比如：

  libxxxx_la_LDFLAGS = -lyaml
  

  这样automake生成的Makefile会自动把依赖库放在正确的位置。
• 重新编译后，用readelf -d libxxxx.so验证，确认输出中出现Shared library: [libyaml.so]的NEEDED条目。

2. 用patchelf修改现有libxxxx.so（无需重新编译） #

如果暂时无法重新编译libxxxx.so，可以用patchelf工具直接修改它的依赖列表：

• 首先安装patchelf（不同系统命令略有不同）：

  # Debian/Ubuntu 系
  sudo apt install patchelf
  # RHEL/CentOS 系
  sudo yum install patchelf
  

• 执行命令添加依赖：

  patchelf --add-needed libyaml.so libxxxx.so
  

• 再次用readelf -d libxxxx.so检查，确认libyaml.so已经出现在NEEDED列表中。

3. 链接可执行文件时手动添加-lyaml（临时 workaround） #

如果上面两种方法都暂时无法实施，可以在链接最终可执行文件的时候，手动把-lyaml加到链接命令里：

gcc -o your_executable your_source.o -lxxxx1 -lyaml

⚠️ 注意：这只是临时解决办法，因为所有用到libxxxx1.so的项目都需要手动添加-lyaml，维护成本很高，不推荐长期使用。

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