Domoticz项目中的Web界面死锁问题分析与解决方案

问题背景

在Domoticz智能家居系统中，用户报告了一个严重的稳定性问题：系统运行1-2天后，Web界面会完全停止响应，同时传感器数据也无法写入数据库。这个问题出现在2024.6和2024.7版本中，运行在Docker容器内的Synology DS218+设备上。

技术分析

通过GDB调试工具对Domoticz进程进行分析，发现了典型的死锁情况：

1. 线程34（MainWorker线程）：

   • 正在执行心跳检查功能(MainWorker::HeartbeatCheck)
   • 尝试获取CWebSocketPush::OnLogMessage中的互斥锁
   • 被阻塞等待

2. 线程47（P1硬件插件线程）：

   • 正在处理Python插件中的设备更新
   • 尝试获取主工作线程中的互斥锁(MainWorker::GetHardware)
   • 也被阻塞等待

这两个线程形成了典型的循环等待死锁条件，导致系统整体挂起。

根本原因

深入分析发现，问题出在CWebSocketPush::OnLogMessage方法中不必要的互斥锁使用。当系统同时满足以下条件时容易触发死锁：

1. 主工作线程执行心跳检查需要记录日志
2. 同时硬件插件线程正在处理设备更新
3. WebSocket推送服务尝试获取日志消息锁

解决方案

Domoticz开发团队在beta版本(16286)中移除了CWebSocketPush::OnLogMessage方法中的冗余互斥锁。经过用户实际测试验证：

1. 新版本已连续运行一周无异常
2. Web界面响应正常
3. 传感器数据记录稳定

技术启示

这个案例展示了在复杂多线程系统中常见的死锁问题。开发者需要注意：

1. 谨慎设计锁的获取顺序
2. 避免在日志记录等高频操作中使用不必要的锁
3. 定期进行多线程压力测试

对于智能家居系统这类需要长期稳定运行的应用，合理的锁策略和线程设计尤为重要。Domoticz团队通过分析用户反馈和调试信息，快速定位并解决了这个影响系统稳定性的关键问题。