NanoMQ Webhook 时间戳问题解析与修复

在物联网消息中间件 NanoMQ 的使用过程中，Webhook 功能作为消息事件推送的重要机制，其数据准确性直接影响着系统集成效果。近期社区反馈了一个关于 Webhook 时间戳异常的典型案例，本文将深入剖析该问题的技术背景、产生原因及解决方案。

问题现象

用户在使用 NanoMQ 0.21 版本时，通过 Webhook 接收到的消息事件中，时间戳字段 ts 出现了异常负值。具体表现为：

• 通过 nanomq_cli 发布测试消息时，收到的时间戳为 -498365439
• 切换至 mosquitto_pub 客户端后，时间戳仍为异常值 -414824511
• 与官方文档描述的秒级时间戳格式不符

技术背景

NanoMQ 的 Webhook 实现基于其底层网络库 NNG 的时间戳功能。原始代码中直接调用了 nng_timestamp() 函数，该函数返回的是纳秒级时间戳。而 Webhook 接口规范明确要求时间戳应为秒级精度，这种精度不匹配导致了数值溢出。

根本原因

问题根源在于两个层面的不匹配：

1. 精度转换缺失：未对 NNG 返回的纳秒级时间戳进行适当转换
2. 类型处理不当：原始实现未考虑大整数在不同精度下的表示范围

解决方案

开发团队在 0.22.2 版本中进行了以下修复：

1. 增加时间精度转换逻辑，将纳秒转换为毫秒
2. 确保时间戳数值在合理范围内
3. 保持与文档描述的一致性

验证结果

升级至 0.22.2 版本后验证显示：

• 时间戳格式变为标准毫秒级（如 1721619140729）
• 兼容各类 MQTT 客户端（包括 nanomq_cli 和 mosquitto_pub）
• 完全符合 Webhook 接口规范

最佳实践建议

对于使用 NanoMQ Webhook 功能的开发者：

1. 建议升级至 0.22.2 或更高版本
2. 对于时间敏感型应用，注意区分秒级和毫秒级时间戳的处理
3. 在集成测试阶段应特别验证时间相关字段的准确性

该问题的修复体现了开源社区对产品质量的持续改进，也提醒开发者在跨模块集成时需要特别注意数据格式的兼容性。