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

问题背景

TeslaMate 是一款用于记录特斯拉车辆数据的开源工具，用户可以通过 Docker 容器部署使用。近期有用户反馈在 TeslaMate 升级过程中出现了充电记录丢失的情况。

问题现象

用户在 2024 年 3 月 22 日 12:50 至 15:49 期间进行了充电操作。在此期间（约 15:20），用户将 TeslaMate 从 1.28.3 版本升级到 1.28.4 版本，升级过程耗时约 20-30 分钟。升级完成后，用户发现在 TeslaMate 的充电记录面板中无法找到该时段的充电记录。

原因分析

1. 服务中断影响：TeslaMate 在升级过程中会暂时停止服务，此时无法从特斯拉 API 获取车辆数据，导致这段时间内的充电数据没有被记录。

2. 未完成的充电过程：当 TeslaMate 服务重启时，如果充电过程尚未完成，系统可能无法正确识别和记录完整的充电会话。

3. 数据同步机制：TeslaMate 主要依赖实时 API 获取数据，服务中断期间的数据无法通过事后补录的方式获取。

解决方案

对于此类因服务中断导致的充电记录丢失问题，TeslaMate 提供了手动修复数据的方案：

1. 识别未完成的充电记录：通过数据库查询找出状态为"未完成"的充电记录。

2. 使用命令行工具完成充电过程：通过执行特定的 Elixir 命令手动标记充电过程为已完成状态。

具体操作命令如下（注意使用单引号而非双引号）：

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

执行成功后，系统会输出充电过程的修正信息，包括相位校正和效率因子确认等。

最佳实践建议

1. 合理安排升级时间：尽量选择车辆不使用时进行 TeslaMate 升级，避免影响数据记录。

2. 定期备份数据：在进行重要操作（如升级）前，备份 TeslaMate 数据库。

3. 监控服务状态：确保 TeslaMate 服务稳定运行，减少意外中断。

4. 及时处理异常记录：发现数据异常时，按照官方文档提供的方法及时修复。

技术原理

TeslaMate 的数据记录机制基于持续监控特斯拉 API 的响应。当服务中断时，系统会丢失这段时间内的所有数据变更。对于充电这类持续过程，系统会在服务恢复后尝试重新连接并获取当前状态，但无法恢复中断期间的历史数据。手动完成充电记录的功能实际上是模拟了系统正常情况下的充电结束处理流程。

通过理解这些机制，用户可以更好地规划 TeslaMate 的维护操作，并在出现问题时采取正确的应对措施。