不能直接用 gin.Default() 启动服务控制设备。需手动配置超时重试、全局 MQTT 单例、状态推送、结构化日志及最小中间件，确保指令可追溯、可重放、可对账。
直接用 gin.Default() 启动服务就能控制设备？不行。物联网场景下，设备状态同步、命令下发延迟、连接中断重试、多设备并发控制这些环节，gin.Default() 默认中间件完全不覆盖，硬上会丢指令、卡响应、甚至让设备“失联”。
设备控制接口必须带超时和重试机制
HTTP 请求本身不保证命令到达设备端，尤其在 MQTT 或 WebSocket 桥接场景中，一次 c.JSON(200, ...) 返回成功，不代表灯真的亮了——可能 broker 没推过去，也可能设备离线缓存未生效。
- 所有控制类接口（如
POST /device/:id/turn-on）必须显式设置上下文超时：c.Request.Context().WithTimeout(5 * time.Second) - 不要依赖 Gin 默认的 HTTP 超时（
r.Run(":8080")不控制业务逻辑耗时），要在 handler 内部用context.WithTimeout包裹设备通信逻辑 - 对关键设备（如门锁、空调），建议在返回前主动轮询一次设备影子状态（Shadow State）或等待 QoS=1 的 PUBACK，而不是仅发完就返回
别把 MQTT 客户端塞进 handler 函数里
每次请求都新建 mqtt.Client 实例，会导致 TCP 连接爆炸、内存泄漏、broker 拒绝连接——这是 IoT 后台最常踩的坑。
- MQTT client 必须全局单例初始化，在
main()启动时创建并保持长连接，不是每次c.POST(...)时 new 一个 - 用
sync.Pool或结构体字段缓存mqtt.Message等临时对象，避免高频 GC - 如果用
github.com/eclipse/paho.mqtt.golang，注意client.Publish()是异步的，要配合token.Wait()或 channel 监听结果，否则返回时命令可能根本没发出
设备状态不能只靠 GET 接口查，得用长连接或事件驱动
前端每 2 秒轮询 GET /device/:id/status，后端就得查一遍 MQTT 订阅主题或数据库，QPS 上去后 DB 和 broker 都扛不住。
立即学习“go语言免费学习笔记（深入）”；
- 优先用 WebSocket 或 Server-Sent Events（SSE）推送设备变更：Gin 原生支持
c.Writer.Hijack()，但更推荐用github.com/gin-gonic/gin+github.com/fasthttp/websocket封装安全连接 - 若必须轮询，状态接口应走内存缓存（如
sync.Map存最近 30 秒设备上报值），而非每次都查 DB 或发 MQTT QUERY - 设备上线/离线事件要监听 MQTT
$SYS/broker/clients/+/connected类主题，更新本地状态映射表，避免“查显示在线，实则断连”
生产环境必须关掉 gin.Default() 的 debug 日志和 panic 恢复
gin.Default() 自带的 Logger() 和 Recovery() 中间件会打印完整请求体、堆栈，IoT 设备上报的二进制 payload 或加密 token 可能被明文落盘，且 panic 捕获掩盖真实连接错误。
- 替换为结构化日志（如
go.uber.org/zap），禁用c.Request.Body和敏感 header 的自动打印 - panic 应交由进程级监控（如 systemd、supervisor）捕获，Gin 层只做 graceful shutdown：收到 SIGTERM 后停止接受新请求，等正在处理的 MQTT publish 完成再退出
- 用
gin.New()替代gin.Default()，手动注册最小必要中间件，比如只加cors.Default()和自定义 auth，其他全删
真正难的不是写几个 r.POST 接口，而是让每条控制指令可追溯、可重放、可对账——设备端 ACK、服务端持久化指令记录、前端操作审计日志，这三者时间戳对齐才叫可控。别让“能调通”等于“能交付”。
