★ FEATURED ARTICLE 简介本资源是配套教程“VS2019编译MQTT库 C/C超详细含示例工程”的完整工程包面向需要在Windows平台使用C接入MQTT协议的开发者尤其适合刚接触paho.mqtt.cpp、希望跳过繁琐编译环节直接上手的中级学习者。压缩包共550个文件约64.21MB涵盖31个cpp源文件、44个h头文件、30个vcxproj工程文件及28个filters筛选器并包含编译产出的dll、lib库与pdb调试符号另有cmake脚本、txt说明和log日志等辅助内容完整保留了从源码到可执行库的构建痕迹。目前已有2978人学习下载。拿到后可直接在VS2019中打开sln解决方案复用已编译好的动态库与静态库对照示例工程理解MQTT客户端连接、订阅与发布流程省去自行配置CMake与依赖的时间快速将MQTT通信能力集成到自己的C项目中。1. 拿到一个 VS2019 编译好的 paho.mqtt.cpp 库先别急着写业务代码如果你正在 Windows 上做 C 的物联网客户端大概率绕不开 MQTT。而 C 这边能用的成熟库不多paho.mqtt.cpp 算是被工业场景反复验证过的一个。问题是这个库官方只给源码编译依赖 paho.mqtt.c、OpenSSL、CMake还要跟 VS2019 的运行时对上很多人卡在编译这一步就放弃了。这份资源直接给的是 VS2019 编译完成的 paho.mqtt.cpp 库省掉的就是从源码到可用二进制这一段最耗时的过程。它适合三类人一是要在 Windows 桌面端或工控机上快速接入 MQTT 的 C 开发者二是教学或实验环境里不想折腾编译链的三是需要把 MQTT 客户端嵌进已有 VS 工程的团队。下面按「库是什么、怎么接、怎么跑、坑在哪」的顺序拆开讲。2. paho.mqtt.cpp 的组成与 VS2019 编译产物结构2.1 这个库到底封装了什么paho.mqtt.cpp 是 Eclipse Paho 项目下的 C 客户端封装底层调用的是 paho.mqtt.c 这个纯 C 库。也就是说你拿到的编译产物里真正干网络收发和协议解析的是 C 库C 层做的是面向对象的包装把回调、异步、同步、持久化这些接口用 C 的类重新组织了一遍。理解这一点很关键因为后面配置链接器的时候C 和 C 两套库都要挂上少一个就是一堆 LNK2019。从功能上看它支持 MQTT 3.1、3.1.1部分版本也支持 5.0。常用的 QoS 0/1/2、遗嘱消息、保留消息、自动重连、SSL/TLS 都在。C 层提供了mqtt::async_client和mqtt::client两个主要入口前者是非阻塞的适合 GUI 或需要同时处理多任务的场景后者是同步阻塞的写脚本或简单工具更顺手。VS2019 编译出来的产物通常包含这几类文件C 层的静态库或动态库paho-mqttpp3.lib/paho-mqttpp3.dll、C 层的库paho-mqtt3a.lib、paho-mqtt3c.lib等、头文件目录以及可能的调试版带d后缀。不同编译选项静态/动态、Debug/Release、是否带 SSL会产出不同的组合拿到资源后第一件事就是把这些文件分类看清楚。2.2 编译产物目录怎么认一份典型的 VS2019 编译输出目录结构大致是这样paho.mqtt.cpp/ ├── include/ │ └── mqtt/ │ ├── async_client.h │ ├── client.h │ ├── message.h │ ├── connect_options.h │ └── ... ├── lib/ │ ├── x64/ │ │ ├── Debug/ │ │ │ ├── paho-mqttpp3d.lib │ │ │ ├── paho-mqtt3ad.lib │ │ │ └── paho-mqtt3cd.lib │ │ └── Release/ │ │ ├── paho-mqttpp3.lib │ │ ├── paho-mqtt3a.lib │ │ └── paho-mqtt3c.lib │ └── x86/ │ └── ... └── bin/ ├── x64/ │ ├── Debug/ │ │ ├── paho-mqttpp3d.dll │ │ ├── paho-mqtt3ad.dll │ │ └── paho-mqtt3cd.dll │ └── Release/ │ └── ... └── x86/ └── ...这里有几个命名规则要记住。paho-mqttpp3是 C 封装层paho-mqtt3a是 C 层的异步库paho-mqtt3c是 C 层的同步库。带d后缀的是 Debug 版不带的是 Release 版。x64 和 x86 是平台位数必须和你的工程目标平台一致32 位工程链 64 位库是直接报错的。提示如果你拿到的目录里只有.lib没有.dll说明是静态库版本链接后不需要额外拷贝 DLL如果两者都有运行时要把 DLL 放到 exe 同目录或系统 PATH 能搜到的路径。2.3 选静态还是动态先看你的分发场景静态库的好处是部署简单编译出来的 exe 不依赖外部 DLL拷过去就能跑。缺点是体积大而且如果多个模块都用 MQTT每个模块都会把库代码复制一份。动态库的好处是多个程序共享一份更新库的时候只换 DLL 就行但部署时要确保目标机器上有对应的运行时。我一般这样判断如果是单机工具、实验 demo、或者交付给不方便装运行时的环境优先静态库如果是公司内部多个服务共用、有统一的部署流程用动态库。VS2019 编译的库还要注意一点它默认可能依赖 VC 2019 运行时vcruntime140.dll、msvcp140.dll目标机器没装的话要么装运行时要么在工程里改成静态链接运行时/MT。3. 在 VS2019 工程里接入这个库的完整步骤3.1 新建工程与平台配置先建一个空白的 C 控制台工程或者打开你已有的工程。右键工程 → 属性先把平台选对。如果你拿到的库是 x64 的就把配置管理器里的平台切成 x64是 x86 的就切 Win32。这一步错了后面全白搭。然后是配置类型。如果你要生成 exe保持 Application如果只是封装一层给别的项目用可以选 Static Library 或 Dynamic Library。大部分人是前者。3.2 头文件路径与库路径配置在工程属性里找到「C/C」→「常规」→「附加包含目录」把include目录加进去。注意是include这一层不是include/mqtt因为代码里写的是#include mqtt/async_client.h。然后在「链接器」→「常规」→「附加库目录」里把对应平台和配置的lib目录加进去。Debug 配置加 Debug 目录Release 加 Release 目录不要混。3.3 链接器输入与依赖顺序在「链接器」→「输入」→「附加依赖项」里把需要的库名写进去。如果你用的是异步客户端至少需要paho-mqttpp3.lib paho-mqtt3a.lib如果用了同步客户端把paho-mqtt3a.lib换成paho-mqtt3c.lib。如果两个都用就都写上。Debug 配置记得加d后缀。顺序上C 层在前C 层在后。链接器是从左到右解析符号的顺序反了可能报未解析的外部符号。3.4 一个最小可运行的发布/订阅示例配置好之后用下面这段代码验证库能不能正常工作。它连接一个本地或测试用的 MQTT broker订阅一个主题然后发一条消息。#include mqtt/async_client.h #include iostream #include thread #include chrono // 回调类处理连接丢失和消息到达 class Callback : public virtual mqtt::callback { public: void connection_lost(const std::string cause) override { std::cout 连接丢失: cause std::endl; } void message_arrived(mqtt::const_message_ptr msg) override { // 收到消息后打印主题和负载 std::cout 收到消息 [ msg-get_topic() ]: msg-to_string() std::endl; } }; int main() { const std::string address tcp://127.0.0.1:1883; // broker 地址 const std::string client_id vs2019_test_client; // 客户端 ID要唯一 const std::string topic test/topic; // 订阅和发布的主题 mqtt::async_client client(address, client_id); Callback cb; client.set_callback(cb); // 连接选项自动重连、清理会话 mqtt::connect_options conn_opts; conn_opts.set_clean_session(true); conn_opts.set_automatic_reconnect(true); try { std::cout 正在连接... std::endl; client.connect(conn_opts)-wait(); // 阻塞等待连接完成 std::cout 连接成功 std::endl; client.subscribe(topic, 1)-wait(); // QoS 1 订阅 std::cout 已订阅: topic std::endl; // 发布一条消息 auto pubmsg mqtt::make_message(topic, hello from vs2019); pubmsg-set_qos(1); client.publish(pubmsg)-wait(); std::cout 消息已发布 std::endl; // 等一会儿让回调打印消息 std::this_thread::sleep_for(std::chrono::seconds(2)); client.disconnect()-wait(); std::cout 已断开 std::endl; } catch (const mqtt::exception exc) { std::cerr MQTT 异常: exc.what() std::endl; return 1; } return 0; }这段代码的逻辑说明async_client构造时传入 broker 地址和客户端 ID客户端 ID 在同一 broker 上必须唯一否则会把前一个连接踢掉。connect_options里开了自动重连和清理会话前者在网络抖动时有用后者表示每次连接都是全新会话不保留离线消息。connect()-wait()是异步接口的同步等待写法wait()会阻塞直到操作完成。订阅和发布都用了 QoS 1保证至少送达一次。回调类里message_arrived是收到消息的入口connection_lost用来观察断线。参数方面address的协议头可以是tcp://或ssl://后者需要额外配置 SSL 选项。client_id建议用设备唯一标识不要用随机数否则每次重连都是新客户端。set_clean_session(true)在需要离线消息的场景要改成false但那样需要 broker 支持会话持久化。3.5 编译与运行时的检查点编译通过后运行前确认三件事一是 broker 是否在跑本地没有的话可以用公共测试 broker 或自己搭一个二是如果用的是动态库DLL 是否在 exe 同目录或 PATH 里三是防火墙有没有拦 1883 端口。如果运行时报「找不到 paho-mqttpp3.dll」把 bin 目录下的 DLL 拷到 exe 旁边。如果报「应用程序无法正常启动 0xc000007b」多半是位数不匹配32 位 exe 链了 64 位库或者反过来。4. 避坑与常见问题排查4.1 链接时报 LNK2019 未解析的外部符号现象编译通过链接阶段报一堆LNK2019符号名里带mqtt::或MQTTClient_。原因通常是库没链全或者 Debug/Release 混用。C 层依赖 C 层只加了paho-mqttpp3.lib没加paho-mqtt3a.lib就会这样。另外 Debug 工程链了 Release 库符号修饰不一样也会报未解析。解决检查附加依赖项里 C 和 C 两层库都在且后缀d和当前配置匹配。用dumpbin /symbols看一下 lib 里到底有没有那个符号确认不是拿错了库。4.2 运行时报缺少 DLL 或 0xc000007b现象exe 双击没反应或弹窗提示缺少paho-mqttpp3.dll或错误码0xc000007b。原因动态库版本没把 DLL 放到运行时能找到的位置0xc000007b基本是位数不匹配。解决把bin下对应平台的 DLL 拷到 exe 同目录。确认工程平台和库平台一致x64 对 x64Win32 对 Win32。如果还不行用 Dependency Walker 或dumpbin /dependents看 exe 到底依赖哪些 DLL。4.3 连接 broker 一直失败或超时现象connect()-wait()长时间不返回或者抛异常说连接被拒绝。原因broker 地址写错、端口不对、broker 没启动、防火墙拦截或者 client_id 冲突被踢。解决先用 MQTT 客户端工具比如 mosquitto_pub/sub确认 broker 可达。检查地址里的端口默认 1883SSL 是 8883。client_id 换成唯一值再试。Windows 防火墙对出站一般不管但入站如果 broker 在本机要注意。4.4 回调不触发或消息收不到现象连接成功、订阅也返回成功但message_arrived一直不打印。原因async_client的回调是在内部线程里跑的如果主线程提前退出回调来不及执行。另外订阅的 QoS 和发布的 QoS 不匹配也可能导致行为异常。解决在主线程里加足够的等待时间或者用条件变量等回调信号。确认订阅的主题和发布的主题完全一致包括大小写和斜杠。QoS 建议先统一用 1 排查。4.5 中文或二进制负载乱码现象发出去的中文消息收到后变成乱码或截断。原因make_message的负载是按字节处理的如果源字符串编码和接收端解析编码不一致就会乱。二进制数据里含\0也可能被截断。解决发送前统一用 UTF-8 编码。二进制负载用mqtt::make_message(topic, payload, length)这个带长度的重载不要用只传字符串的版本。5. 进阶SSL 连接与多线程下的客户端管理5.1 配置 SSL/TLS 连接如果 broker 要求加密连接地址改成ssl://然后配置mqtt::ssl_options。下面是一个最小示例mqtt::connect_options conn_opts; conn_opts.set_clean_session(true); conn_opts.set_automatic_reconnect(true); // SSL 配置设置信任库和证书 mqtt::ssl_options ssl_opts; ssl_opts.set_trust_store(ca.crt); // CA 证书路径 ssl_opts.set_key_store(client.pem); // 客户端证书双向认证时需要 ssl_opts.set_private_key(client.key); // 客户端私钥 ssl_opts.set_verify(true); // 开启证书校验 conn_opts.set_ssl(ssl_opts); mqtt::async_client client(ssl://broker.example.com:8883, ssl_client); client.connect(conn_opts)-wait();这里set_verify(true)是生产环境必须开的关掉校验等于裸奔。set_trust_store指向 CA 证书用来验证 broker 身份。如果是双向认证还要提供客户端证书和私钥。证书格式一般是 PEM路径用绝对路径或相对于工作目录的路径相对路径在 VS 里调试时容易找不到建议用绝对路径。5.2 多线程环境下的注意事项async_client本身是线程安全的但有几个边界要注意。一是回调是在库的内部线程执行的不要在回调里做耗时操作否则会阻塞消息处理。二是publish和subscribe返回的 token 可以在多个线程里wait()但同一个 token 不要重复 wait。三是客户端对象的生命周期要覆盖所有异步操作如果对象先析构了回调可能访问到已释放的内存。我一般的做法是把async_client放在一个长生命周期的管理类里用智能指针持有析构时先disconnect()-wait()再释放。回调里只做数据拷贝和投递到队列真正的业务处理放到工作线程。5.3 验证库是否正常工作的几个检查点拿到一份编译好的库怎么确认它是完整可用的我通常按这个顺序过一遍先编译一个最小连接程序确认头文件和库路径没问题再跑发布订阅确认 C 层和 C 层都链上了然后测断线重连把 broker 停掉再启动看connection_lost和自动重连是否触发最后测 SSL确认证书配置正确。这四步过了基本可以放心用到项目里。从那以后我每次拿到第三方编译好的库都会先跑一遍这个最小验证流程不直接往业务工程里塞。很多问题在最小程序里暴露出来比在复杂工程里排查省事得多。希望帮到你。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
