OpenDTU项目中的Prometheus API面板信息错乱问题分析

问题背景

在OpenDTU项目中，当用户配置多个Hoymiles逆变器时，Prometheus API接口返回的面板信息出现了错乱现象。具体表现为：第一个逆变器(INV1)的面板名称显示为第二个逆变器(INV2)的面板名称，而第二个逆变器则显示第一个逆变器的面板名称。同时，最大功率(MaxPower)信息也出现了同样的错位问题。

问题复现条件

该问题在以下条件下可以复现：

1. 系统中配置了两个或更多DTU设备
2. 为每个逆变器设置了不同的面板名称
3. 调用/api/prometheus/metric接口获取监控数据

技术分析

从问题描述和截图可以看出，WebApiPrometheusClass类中的addPanelInfo方法存在逻辑错误。该方法负责将逆变器的面板信息添加到Prometheus指标输出中，但在处理多个逆变器时，错误地将不同逆变器的信息进行了交叉关联。

具体表现为：

• 对于HM-300逆变器(单串)，显示的是HM-600逆变器的面板名称
• 对于HM-600逆变器(双串)，只显示了一个面板名称，且该名称实际上是HM-300的面板名称
• 第二个面板的名称完全缺失

影响范围

该问题影响所有使用多逆变器配置的OpenDTU用户，特别是那些依赖Prometheus API进行监控和数据收集的用户。错误的面板信息会导致监控系统无法正确识别和区分不同逆变器的数据，影响监控准确性和告警功能。

解决方案

项目维护者tbnobody已经确认了该问题，并在后续版本中进行了修复。修复方案主要涉及以下几个方面：

1. 修正addPanelInfo方法中的逆变器信息索引逻辑
2. 确保每个逆变器的面板信息与其序列号正确对应
3. 正确处理多串逆变器的所有面板信息

用户建议

对于遇到此问题的用户，建议：

1. 升级到包含修复的OpenDTU版本
2. 在升级后重新检查面板配置信息
3. 验证Prometheus API返回的数据是否与实际配置一致

总结

这个案例展示了在物联网设备管理系统中，正确处理多设备信息的重要性。OpenDTU作为光伏逆变器监控系统，其数据的准确性直接影响用户对光伏系统运行状态的判断。开发团队对问题的快速响应和修复体现了项目的专业性和可靠性。