NanoMQ CLI工具消息发布后阻塞问题的分析与解决

问题背景

在NanoMQ项目使用过程中，用户反馈通过nanomq_cli命令行工具发布MQTT消息时遇到一个典型问题：当执行nanomq_cli pub命令发布消息后，进程不会自动退出，而是持续保持运行状态，必须通过手动中断（如Ctrl+C）才能终止进程。这种行为在自动化脚本场景中会带来严重问题，因为后续命令无法正常执行。

技术分析

预期行为

MQTT客户端工具在完成消息发布任务后，理论上应该：

1. 建立与broker的TCP连接
2. 成功发送消息负载
3. 正常断开连接
4. 进程退出并返回适当的退出码（0表示成功）

实际现象

通过Docker环境复现发现：

1. 消息确实能成功发布到broker
2. 客户端日志显示连接建立（connect result: 0）和断开（disconnected reason: 0）
3. 但进程仍然保持运行状态
4. 必须通过信号中断才能退出

根本原因

经开发团队排查，问题源于底层NNG库的nng_fini()函数未按预期工作。该函数负责清理网络资源和终止相关线程，但在特定情况下未能正确执行完成，导致主线程无法正常退出。

解决方案

开发团队已提交修复代码，主要改进点包括：

1. 完善资源清理机制
2. 确保所有网络线程正确终止
3. 优化客户端生命周期管理

修复后的版本将表现出符合预期的行为：

• 单次发布后立即退出
• 支持脚本自动化场景
• 返回正确的退出状态码

最佳实践建议

对于需要自动化MQTT消息发布的场景，建议：

1. 升级到包含此修复的NanoMQ版本（0.22.8之后）
2. 在脚本中添加超时处理作为防御性编程
3. 检查命令返回值确保发布成功
4. 对于关键业务场景，建议增加消息确认机制