EVCC项目中Solax逆变器功率显示异常问题解析

问题背景

在EVCC项目0.203.0版本更新后，部分用户报告其Solax逆变器设备出现功率显示为0W的问题。该问题主要影响通过云API连接的Solax逆变器设备，包括普通逆变器和混合逆变器两种类型。

问题根源分析

通过开发者与用户的交互调试，发现问题的核心在于API请求中tokenId参数的格式处理异常。具体表现为：

1. 在0.203.0版本之前，tokenId能够被正确传递为纯数字字符串
2. 更新后，系统错误地在tokenId前后添加了单引号编码(%27)
3. 更严重的是，当用户尝试移除配置文件中的引号时，系统又将长数字转换为了科学计数法格式

这些格式变化导致Solax云API无法识别token，返回"token invalid"错误，进而导致功率数据无法获取。

解决方案演进

开发团队分两个阶段解决了这一问题：

第一阶段修复

针对普通逆变器模板(solax-inverter-cloud.yaml)的修复：

• 修正了tokenId参数的字符串处理逻辑
• 确保长数字token能够以原始字符串形式传递
• 移除了不必要的引号编码

第二阶段扩展修复

在确认混合逆变器模板(solax-hybrid-cloud.yaml)也存在同样问题后：

• 将相同的修复方案扩展到所有三种使用类型(pv, battery, grid)
• 确保统一的参数处理逻辑

验证方法

用户可以通过以下方式验证修复效果：

1. 使用trace日志级别查看原始API请求
2. 确认tokenId参数是否以原始数字字符串形式传递
3. 检查API响应是否返回有效数据而非token错误

用户操作建议

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

1. 升级到包含修复的EVCC版本(0.203.5及以上)
2. 检查配置文件中的tokenId格式是否正确
3. 如有疑问，可通过trace日志验证API请求格式

技术启示

此案例展示了几个重要的开发经验：

1. 长数字字符串在配置文件中需要特殊处理，避免被误解析为数字
2. API参数格式必须严格遵循服务提供方的要求
3. 模板系统的修改需要考虑所有相关使用场景
4. 详细的日志记录对问题诊断至关重要

通过这次问题的解决，EVCC项目对设备模板系统的稳健性有了进一步提升，为未来类似问题的预防和处理积累了宝贵经验。