TeslaMate 充电记录丢失问题分析与解决方案

问题背景

TeslaMate 是一款流行的特斯拉车辆数据记录工具，它能够详细记录车辆的充电、行驶等数据。近期有用户反馈在升级 TeslaMate 1.28.3 到 1.28.4 版本过程中，出现了充电记录丢失的情况。

问题现象

用户在 2024 年 3 月 22 日 12:50 至 15:49 期间进行了充电操作。在 15:20 左右，用户进行了 TeslaMate Docker 容器的升级，升级过程持续约 20-30 分钟。升级完成后，用户发现在 TeslaMate 的充电记录仪表板中无法找到这次充电记录，但在状态仪表板中仍能看到充电状态的变更。

技术分析

这种数据丢失现象的根本原因是 TeslaMate 在升级过程中处于离线状态，无法持续从特斯拉 API 获取车辆数据。TeslaMate 的工作原理是持续轮询特斯拉 API 来记录车辆状态变化，当服务中断时，这段时间内的数据自然无法记录。

具体到充电记录丢失的情况，这是因为充电过程被意外中断，TeslaMate 没有收到充电完成的信号，导致系统认为这是一个未完成的充电过程，因此不会在充电记录仪表板中显示。

解决方案

对于这种因服务中断导致的未完成充电记录，TeslaMate 提供了手动修复数据的方案：

1. 首先需要确定未完成充电记录的 ID
2. 使用以下命令手动标记充电过程为已完成：

docker compose exec teslamate bin/teslamate rpc 'TeslaMate.Repo.get!(TeslaMate.Log.ChargingProcess, 充电记录ID) |> TeslaMate.Log.complete_charging_process()'

执行成功后，系统会输出充电完成信息，包括相位校正和效率因子确认等数据。此时刷新 TeslaMate 界面，就能看到完整的充电记录了。

预防措施

为避免类似问题发生，建议：

1. 在车辆不活跃时（如夜间）进行 TeslaMate 升级
2. 升级前确保没有进行中的充电或行驶过程
3. 考虑设置 TeslaMate 的高可用性部署，减少服务中断时间
4. 定期备份 TeslaMate 数据库，以防数据丢失

总结

TeslaMate 作为数据记录工具，依赖持续的网络连接和服务运行。服务中断会导致数据记录不完整，特别是对于充电这种需要明确开始和结束状态的操作。了解这一原理后，用户可以通过手动修复命令解决类似问题，同时采取预防措施减少问题发生概率。