76 lines
1.9 KiB
Markdown
76 lines
1.9 KiB
Markdown
|
# 异步MQTT服务安装指南
|
|||
|
|
|
|||
|
|
## 依赖安装
|
|||
|
|
|
|||
|
|
为了使用高性能的异步MQTT服务，需要安装额外的依赖：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pip install aiomqtt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 配置说明
|
|||
|
|
|
|||
|
|
系统会自动检测是否安装了 `aiomqtt`：
|
|||
|
|
|
|||
|
|
- **如果已安装 aiomqtt**：系统将使用异步MQTT客户端，提供更好的并发性能
|
|||
|
|
- **如果未安装 aiomqtt**：系统会回退到同步MQTT客户端，但包装为异步接口
|
|||
|
|
|
|||
|
|
## 性能对比
|
|||
|
|
|
|||
|
|
### 异步MQTT服务优势：
|
|||
|
|
1. **高并发处理**：可以同时处理大量设备的消息
|
|||
|
|
2. **非阻塞IO**：消息处理不会阻塞其他操作
|
|||
|
|
3. **更好的资源利用**：减少线程开销
|
|||
|
|
4. **自动重连**：内置连接管理和自动重连机制
|
|||
|
|
|
|||
|
|
### 适用场景：
|
|||
|
|
- 大量设备同时连接（>50个设备）
|
|||
|
|
- 高频率消息传输（>100消息/秒）
|
|||
|
|
- 对延迟敏感的应用
|
|||
|
|
- 需要可靠连接管理的场景
|
|||
|
|
|
|||
|
|
## 使用方法
|
|||
|
|
|
|||
|
|
系统会自动选择最佳的MQTT服务：
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
# 设备处理服务会自动使用异步MQTT（如果可用）
|
|||
|
|
from services.online_script.device_handler_service import get_device_service
|
|||
|
|
|
|||
|
|
device_service = get_device_service()
|
|||
|
|
await device_service.start_service()
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 监控和调试
|
|||
|
|
|
|||
|
|
可以通过以下方式检查MQTT服务状态：
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
# 获取连接信息
|
|||
|
|
connection_info = device_service.registry.mqtt_service.get_connection_info()
|
|||
|
|
print(f"异步模式: {connection_info['async_mode']}")
|
|||
|
|
print(f"连接状态: {connection_info['connected']}")
|
|||
|
|
print(f"订阅主题: {connection_info['subscribed_topics']}")
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 故障排除
|
|||
|
|
|
|||
|
|
### 1. 如果aiomqtt安装失败
|
|||
|
|
```bash
|
|||
|
|
# 尝试升级pip
|
|||
|
|
pip install --upgrade pip
|
|||
|
|
pip install aiomqtt
|
|||
|
|
|
|||
|
|
# 或者使用conda安装
|
|||
|
|
conda install -c conda-forge aiomqtt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 如果连接问题
|
|||
|
|
- 检查MQTT服务器配置
|
|||
|
|
- 确认网络连接
|
|||
|
|
- 查看日志中的错误信息
|
|||
|
|
|
|||
|
|
### 3. 性能问题
|
|||
|
|
- 监控CPU和内存使用
|
|||
|
|
- 检查消息处理频率
|
|||
|
|
- 考虑调整MQTT配置参数
|