核心用法
mqtt-client 是一个基于 Python 的轻量级 MQTT 客户端实现，设计为后台常驻进程模式运行。用户通过配置 .env 文件设置连接参数（Broker 地址、端口、认证信息等），执行 scripts/run.py 即可建立与 MQTT 服务器的持久连接，并实时监听订阅的主题消息。
典型工作流程：
1. 编辑 .env 文件配置 MQTT 连接参数
2. 运行 scripts/run.py 启动后台监听进程
3. 客户端持续接收并处理订阅主题的消息
显著优点
- 轻量简洁：纯 Python 实现，依赖简单，部署门槛低
- 后台常驻：设计为持久连接模式，适合长期运行的数据订阅场景
- 配置灵活：通过环境变量管理连接信息，便于容器化部署和密钥隔离
- 协议标准：基于 MQTT 3.1/3.1.1/5.0 工业标准协议，兼容主流 Broker（Mosquitto、EMQX、AWS IoT Core 等）
潜在缺点与局限性
- 功能基础：仅实现核心订阅功能，缺乏高级特性如 QoS 等级控制、自动重连策略、消息持久化、TLS 双向认证等配置透明度
- 无内置安全机制：依赖外部环境变量管理敏感凭证，若
.env权限配置不当存在泄露风险 - 监控运维缺失：无内置健康检查、连接状态上报或日志分级机制
- 单点运行：未提供高可用或多实例协调机制
适合人群
- IoT 开发者需要快速搭建 MQTT 数据接收端
- 边缘计算场景下的轻量级消息订阅代理
- 原型验证阶段需要最小可用 MQTT 客户端的敏捷团队
- 已有成熟 MQTT Broker 基础设施，仅需简单消费端集成的场景
常规风险
- 凭证泄露：
.env文件若未正确设置文件权限（如误提交至版本控制），可能导致 MQTT 认证信息暴露 - 网络暴露：若配置不当可能连接至公网未加密 Broker，存在中间人攻击风险
- 资源泄露：后台进程异常退出时可能存在连接未正确关闭，导致 Broker 侧僵尸连接累积
- 依赖风险：未明确锁定 Python MQTT 库版本，存在供应链更新引发兼容性问题的可能