Windows下链接Mosquitto库解决编译错误：cannot find -lmosquitto

问题描述 #

在Windows环境下使用C语言开发Mosquitto客户端，已通过预构建安装包完成Mosquitto库与Broker的安装，Broker运行正常且可通过命令行发布消息。编写简单C客户端代码后，编译阶段先解决了头文件引用问题，但出现链接错误：cannot find -lmosquitto；添加-L参数指定库路径后编译成功，运行程序时却提示：error while loading shared libraries: ?: cannot open shared object file: No such file or directory。

客户端代码 #

#include <stdio.h>
#include "mosquitto.h"

int main () {
   int rc;
   struct mosquitto * vsp_client;
   
   mosquitto_lib_init();
   vsp_client = mosquitto_new("vsp", true, NULL);
   rc = mosquitto_connect(vsp_client, "localhost", 1883, 60);
   if(rc != 0) {
      printf("VSP client could not connect to broker!  Error Code: %d\n", rc);
      mosquitto_destroy(vsp_client);
      return -1;
   }
   printf("We are now connected to the broker!\n");
   mosquitto_publish(vsp_client, NULL, "test/t1", 6, "Hello", 0, false);
   mosquitto_disconnect(vsp_client);
   mosquitto_destroy(vsp_client);
   mosquitto_lib_cleanup();
   return 0;
};

编译命令 #

• 初始编译：gcc vsp.c -o vsp -lmosquitto
• 添加头文件路径后：gcc vsp.c -o vsp -lmosquitto -I"C:\Program Files\mosquitto\devel"
• 添加库路径后：gcc vsp.c -o vsp -lmosquitto -I"C:\Program Files\mosquitto\devel" -L"C:\Program Files\mosquitto\devel"

解决方法 #

方法1：复制动态库到程序运行目录 #

找到Mosquitto安装目录下bin文件夹中的mosquitto.dll文件（通常路径为C:\Program Files\mosquitto\bin），将其复制到你的可执行文件vsp.exe所在的同一目录下，运行程序即可正常加载依赖库。

方法2：添加Mosquitto bin目录到系统PATH环境变量 #

1. 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
2. 在系统变量列表中找到PATH，点击「编辑」
3. 添加路径C:\Program Files\mosquitto\bin（根据实际安装路径调整）
4. 保存设置后，重启命令提示符或终端，再运行程序

方法3：静态链接Mosquitto库（推荐，避免运行时依赖） #

如果你的Mosquitto预构建包包含静态库文件（通常为libmosquitto.a或mosquitto.lib，位于devel目录下），可以在编译时添加-static参数进行静态链接，生成的可执行文件会打包库代码，无需额外依赖动态库。修改后的编译命令为：

gcc vsp.c -o vsp -static -lmosquitto -I"C:\Program Files\mosquitto\devel" -L"C:\Program Files\mosquitto\devel"

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