直接用Paho MQTT C++库走4G模组发MQTT行不通，因其依赖系统TCP栈，而4G模组（如EC20、SIM7600）不暴露标准socket接口，需先通过AT指令或QMI拨号建立网络连接，并确保IP可达、路由正确、MQTT绑定4G接口、TLS版本达标、离线缓存启用、阿里云签名合规。
直接用 Paho MQTT C++ 库走 4G 模组发 MQTT 是行不通的——它默认依赖系统 TCP 栈，而多数 4G 模组（如 EC20、SIM7600、BG96）不暴露标准 socket 接口，而是通过 AT 指令控制 PPP 拨号或 QMI/RMNET 网络通道。必须先让模组联网，再让 C++ 程序走真实 TCP 连接。
确认 4G 模组已建立可用网络连接
这是最容易卡住的第一步。不能假设 AT+CGATT? 返回 1 就代表能上网——它只表示附着到蜂窝网，不等于获得 IP 或路由可达。
- 用
AT+CGPADDR查看是否分配到 IPv4 地址（非0.0.0.0） - 用
AT+PING测试能否通公网 DNS（如114.114.114.114），不是 ping 阿里云域名（DNS 解析可能失败） - 在 Linux 网关上运行
ifconfig或ip a，确认wwan0/ppp0接口 UP 且有有效 IP - 若使用 QMI 拨号（常见于高通方案），需确保
qmi-network已 start 且路由表含默认网关（ip route show default）
MQTT 客户端必须绑定到 4G 网络接口
默认情况下，mqtt::client 会走系统默认路由，可能误走以太网或 WiFi。若网关同时有多个网口，必须强制指定出口。
- Linux 下可通过
bind到本地 4G 接口 IP 实现：构造mqtt::connect_options时调用.set_network_interface("wwan0")（Paho C++ 1.3+ 支持） - 若版本旧不支持，改用
set_socket_options()+ 自定义 socket 创建逻辑，在socket()后立即bind()到wwan0的 IP - 验证方式：连接时抓包
tcpdump -i wwan0 port 1883，确认 SYN 包确实从该接口发出 - 阿里云/华为云等平台要求 TLS 1.2+，务必确认 OpenSSL 版本 ≥ 1.1.1，否则握手失败静默断连
处理弱网下的重连与离线缓存
4G 信号波动频繁，connect() 成功不等于后续 publish 不失败；QoS 0 消息丢了就没了，QoS 1/2 在断连期间无法确认，必须靠客户端缓冲。
立即学习“C++免费学习笔记（深入）”；
- 启用 Paho 的内置离线缓冲：构造 client 时传入
mqtt::file_persistence或自定义mqtt::persistence实现，避免内存消息随进程退出丢失 - 禁用
clean_session = true，改用false+ 固定client_id，让 broker 缓存未投递的 QoS 1/2 消息（注意阿里云对 session 过期时间限制为 2 小时） - 不要依赖 Paho 的自动重连（
automatic_reconnect(true)）——它只重试连接，不重发未确认的 publish；需监听connection_lost回调，手动重发待确认队列 - 设置合理
keep_alive_interval（建议 60–120 秒），太短加重模组负担，太长导致断连检测延迟
阿里云 IoT 平台接入的特殊参数
阿里云不接受通用 MQTT 连接，必须按其签名规则生成 username/password，并使用特定 topic 前缀。Paho C++ 本身不处理签名，这部分必须手写。
-
username格式为${deviceName}|securemode=3,signmethod=hmacsha256,timestamp=${timestamp}|，其中timestamp是毫秒级当前时间 -
password是对字符串clientId${client_id}deviceName${deviceName}productKey${productKey}timestamp${timestamp}做 HMAC-SHA256 再 hex 编码 - Broker 地址不是固定域名，而是形如
ssl://<productkey>.iot-as-mqtt.cn-shanghai.aliyuncs.com:1883</productkey>（注意是ssl://，即使端口是 1883） - 发布属性数据的主题必须是
/sys/${productKey}/${deviceName}/thing/property/post，payload 是标准 JSON，含method,params,id字段
真正难的不是发一条消息，而是让整个链路在 4G 信号闪断、IP 重拨、DNS 临时失效、平台 token 过期这些真实场景下持续运转。所有“自动”功能都要拆开验明正身——Paho 的 automatic_reconnect 不管 payload 重发，OpenSSL 的 TLS 握手失败不会抛出可捕获异常，阿里云的 signature 有效期只有 15 分钟。这些细节不逐个击穿，网关上线三天后必掉线。
