Ubuntu下VSCode中Makefile编译成功但运行时找不到Mosquitto .so库

问题根源分析 #

编译通过但运行时找不到libmosquittopp.so.1，是因为动态链接器默认只搜索系统标准库路径（如/lib、/usr/lib），而你自行编译的Mosquitto库在/usr/src/mosquitto下的自定义路径，不在默认搜索范围内。
编译时用-lmosquittopp失败，则是因为编译器未被告知库的搜索路径，无法找到对应库文件。

分步解决方案 #

1. 确认库文件的实际路径

先定位编译好的库文件位置，执行：

find /usr/src/mosquitto -name "libmosquittopp.so.1"

假设输出为/usr/src/mosquitto/lib/libmosquittopp.so.1，后续步骤均以此路径为例。

2. 修复编译阶段-l参数失效问题

修改Makefile的链接规则，添加-L指定库的搜索路径，再用-l指定库名：

# 示例链接规则
main: main.o
    g++ -o bin/main main.o -L/usr/src/mosquitto/lib -lmosquittopp -lmosquitto

• -L/usr/src/mosquitto/lib：告诉编译器去该目录找库
• -lmosquittopp、-lmosquitto：简写库名（自动匹配libmosquittopp.so）

3. 修复运行时动态库找不到的问题

有三种可行方案，按需选择：

方案一：临时生效（仅当前终端会话）

运行程序前先设置环境变量，告知动态链接器额外的库路径：

export LD_LIBRARY_PATH=/usr/src/mosquitto/lib:$LD_LIBRARY_PATH
./bin/main

方案二：系统级永久生效

将库路径添加到动态链接器的配置文件：

# 创建配置文件
echo "/usr/src/mosquitto/lib" | sudo tee /etc/ld.so.conf.d/mosquitto.conf
# 更新动态链接器缓存
sudo ldconfig

之后任何终端运行程序都无需额外设置。

方案三：编译时嵌入库路径（程序级永久生效）

修改Makefile的链接规则，添加-Wl,-rpath参数，让程序自身携带库搜索路径：

main: main.o
    g++ -o bin/main main.o -L/usr/src/mosquitto/lib -lmosquittopp -lmosquitto -Wl,-rpath=/usr/src/mosquitto/lib

编译后的程序会自动到指定路径找库，不受系统环境影响。

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