MQTTnet.AspNetCore.Routing 是 MQTTnet 的可选扩展。它让开发者可以像写 ASP.NET Core Controller 一样处理 MQTT topic 上的入站消息,把消息处理逻辑组织成 controller 和 action。
什么时候需要它
如果 MQTT 服务端主要只是转发消息,用 MQTTnet delegate 直接处理就够了。但当服务端要做大量入站消息验证、解析、路由、授权、日志、业务处理和依赖注入时,单个 delegate 很快会膨胀。
MQTTnet.AspNetCore.Routing 的价值就是把这些逻辑拆回熟悉的 Web API 风格:不同 topic 对应不同 action,业务依赖通过构造函数注入,payload 可以按参数绑定。
熟悉的开发范式
README 中给出的例子使用 AddMqttControllers() 注册控制器,通过 server.WithAttributeRouting(app.Services, allowUnmatchedRoutes: false) 启用 attribute routing。
控制器继承 MqttBaseController,使用 [MqttController] 和 [MqttRoute] 标记路由。例如 {zipCode:int}/temperature 可以把 topic 片段绑定为整数参数,[FromPayload] 可以把 JSON payload 反序列化成业务对象。
这和 ASP.NET Core 的 [FromBody]、路由模板、依赖注入非常接近,降低了 Web 开发者进入 MQTT 服务端开发的门槛。
支持范围
项目 README 标明支持 .NET 8 和 .NET 10,支持 MQTT 5.0.0、3.1.1 和 3.1.0。它也可以和其他 MQTTnet options 一起使用,因此更像是一个组织代码的路由层,而不是完整替代 MQTTnet。
在 IoT 平台里的价值
IoT 平台常见 topic 会越来越多:设备遥测、属性上报、命令响应、网关事件、日志、OTA 状态、边缘节点心跳。如果全部写在同一个处理函数里,维护成本会快速上升。
用 Controller 方式组织 MQTT 入站消息,可以让不同业务域独立演进。例如遥测控制器、属性控制器、设备事件控制器、网关控制器、诊断控制器分别处理自己的 topic。
生产注意事项
README 也提醒该库尚未针对极高负载环境充分测试。生产项目应该做自己的压测,尤其要关注 topic 匹配、payload 反序列化、依赖注入生命周期、异常处理和背压策略。
它适合提升代码组织度,但高吞吐 MQTT 服务端仍要把性能测试和消息可靠性放在第一位。