交叉编译Paho MQTT C/C++库时非零QoS发布报错问题

问题核心 #

在Windows WSL2的Ubuntu 20.04环境下交叉编译树莓派3B（ARM架构）的MQTT代码时，出现以下异常：

• 订阅功能正常，QoS 0发布无问题
• 使用QoS 1/2发布时，触发错误：MQTT error [-9]: Invalid QoS value
• 使用非法QoS值（<0或>2）发布时，错误提示变为：MQTT error [-9]: Bad QoS
• 同一代码在树莓派本地编译运行完全正常
• 两个错误提示分别来自Paho C++库的mqtt/message.h和底层C库的MQTTAsync.c

根本原因 #

问题出在交叉编译时Paho C/C++库的版本不匹配，或者底层C库编译配置缺失QoS 1/2支持：

• Paho C++库依赖C库提供核心功能，若交叉编译C库时未启用异步客户端或完整QoS支持的编译宏，会导致上层调用合法QoS值时，底层库判定为无效值。
• 另外，交叉编译的ARM架构目标参数配置错误，可能导致库的二进制兼容性异常，触发参数校验逻辑紊乱。

解决步骤 #

1. 重新交叉编译Paho C库（底层依赖） #

确保编译时开启完整QoS支持，步骤如下：

• 下载与树莓派本地编译版本一致的Paho C库源码
• 设置交叉编译工具链：

  export CC=arm-linux-gnueabihf-gcc
  export CXX=arm-linux-gnueabihf-g++
  export AR=arm-linux-gnueabihf-ar
  export LD=arm-linux-gnueabihf-ld
  

• 配置编译选项，强制启用异步客户端和完整QoS支持：

  cmake -B build -S . \
    -DCMAKE_SYSTEM_NAME=Linux \
    -DCMAKE_SYSTEM_PROCESSOR=arm \
    -DCMAKE_C_COMPILER=$CC \
    -DCMAKE_CXX_COMPILER=$CXX \
    -DPAHO_BUILD_SHARED=ON \
    -DPAHO_BUILD_STATIC=ON \
    -DPAHO_BUILD_EXAMPLES=OFF \
    -DPAHO_ENABLE_ASYNC=ON \
    -DPAHO_WITH_SSL=OFF  # 按需开启SSL，先简化配置
  

• 编译并安装到ARM目标库目录：

  cmake --build build --parallel
  sudo cmake --install build --prefix=/path/to/arm-target-libs
  

2. 重新交叉编译Paho C++库 #

确保C++库链接到刚编译的ARM版本C库：

• 下载与本地版本一致的Paho C++库源码
• 配置编译时指定C库路径：

  cmake -B build -S . \
    -DCMAKE_SYSTEM_NAME=Linux \
    -DCMAKE_SYSTEM_PROCESSOR=arm \
    -DCMAKE_C_COMPILER=$CC \
    -DCMAKE_CXX_COMPILER=$CXX \
    -DPAHO_C_INCLUDE_DIR=/path/to/arm-target-libs/include \
    -DPAHO_C_LIB=/path/to/arm-target-libs/lib/libpaho-mqtt3a.so \
    -DPAHO_BUILD_SHARED=ON \
    -DPAHO_BUILD_STATIC=ON \
    -DPAHO_BUILD_EXAMPLES=OFF
  

• 编译安装到同一目标路径：

  cmake --build build --parallel
  sudo cmake --install build --prefix=/path/to/arm-target-libs
  

3. 修正项目编译链接配置 #

确保项目交叉编译时，链接的是ARM版本的Paho库而非主机（x86）版本：

• 若用CMake，在CMakeLists.txt中添加：

  link_directories(/path/to/arm-target-libs/lib)
  include_directories(/path/to/arm-target-libs/include)
  target_link_libraries(your_project_name paho-mqttpp3 paho-mqtt3a)
  

• 若直接用g++编译：

  arm-linux-gnueabihf-g++ your_code.cpp -o your_binary \
    -I/path/to/arm-target-libs/include \
    -L/path/to/arm-target-libs/lib \
    -lpaho-mqttpp3 -lpaho-mqtt3a
  

4. 验证代码中QoS参数传递 #

确保代码中QoS参数传递无类型错误：

• 检查发布消息的代码，确保QoS参数为合法int类型，避免类型截断：

  mqtt::message msg("topic", payload, 1, false);  // QoS=1，参数为int类型，无隐式转换
  client.publish(msg);
  

验证方法 #

将重新编译的二进制文件传到树莓派测试：

scp your_binary pi@raspberrypi:/home/pi/
ssh pi@raspberrypi "./your_binary"

若QoS 1/2发布正常，说明问题解决。

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