执行测试二进制文件时libxcb-errors.so.0加载错误的解决问询

你的问题本质是编译链接阶段能找到库，但运行时动态链接器找不到——虽然libxcb-errors.so.0确实存在于/usr/local/lib，但这个路径可能不在动态链接器的默认搜索列表里，或者你的测试程序没有被配置为在运行时自动搜索这个路径。下面是几个可行的解决方案，按从临时到永久的顺序排列：

1. 临时测试：设置LD_LIBRARY_PATH环境变量 #

这是最快的临时解决方法，运行测试程序前先指定动态链接器的搜索路径：

LD_LIBRARY_PATH=/usr/local/lib ./$(TEST)

不过这个方法只对当前终端会话有效，每次运行都要手动设置，适合快速验证问题。

2. 系统级永久添加搜索路径 #

如果/usr/local/lib不是系统动态链接器的默认搜索路径（很多发行版默认不包含），可以把它添加到全局配置里：

• 编辑/etc/ld.so.conf.d/local.conf文件（如果不存在就创建），添加一行：

  /usr/local/lib
  

• 然后运行sudo ldconfig更新动态链接器的缓存
  这样所有程序都会自动搜索/usr/local/lib下的库，适合系统级安装的库。

3. 在编译测试程序时嵌入rpath（推荐开发场景） #

更优雅的方式是在编译测试程序时，告诉它运行时要去/usr/local/lib找依赖库——也就是添加rpath参数。修改你的Makefile中测试程序的编译规则：

方法A：手动指定路径 #

$(TEST): $(TEST-SRC) $(BIN)
    $(CC) $(TEST-SRC) -o $@ $(PREFIX_LIB)/$(TARGET) -Wl,-rpath=/usr/local/lib

方法B：用pkg-config自动获取路径（更灵活） #

既然你已经用pkg-config来管理xcb-errors的链接参数，可以直接用它获取库的安装路径，避免硬编码：

LIBS_DYNAMIC = $(shell pkg-config --libs xcb-errors)
# 获取xcb-errors的安装目录
XCB_ERRORS_LIBDIR = $(shell pkg-config --variable=libdir xcb-errors)

$(TEST): $(TEST-SRC) $(BIN)
    $(CC) $(TEST-SRC) -o $@ $(PREFIX_LIB)/$(TARGET) $(LIBS_DYNAMIC) -Wl,-rpath=$(XCB_ERRORS_LIBDIR)

这样即使xcb-errors的安装路径变化，你的Makefile也不需要手动修改。

为什么之前的Makefile会出问题？ #

你的测试程序编译规则里只链接了自己的mylib.so，但没有处理mylib.so依赖的xcb-errors库的运行时路径。虽然mylib.so在编译时已经链接了xcb-errors，但动态链接器在运行测试程序时，需要能找到所有依赖的库——要么系统默认路径里有，要么程序通过rpath指定，要么通过环境变量临时告知。

内容的提问来源于stack exchange，提问作者jorge is not ai