TeslaMate 服务异常排查：磁盘空间与时区配置问题分析

问题现象

TeslaMate 是一款流行的特斯拉车辆数据记录和分析工具。近期有用户报告其 TeslaMate 服务在正常运行1-4天后出现"Bad Gateway"错误，同时 Grafana 仪表板显示"404 page not found"。该问题在恢复备份后能暂时解决，但数日后会再次出现。

根本原因分析

经过深入排查，发现该问题主要由两个关键因素导致：

1. 磁盘空间耗尽：长期运行的 Docker 环境积累了大量的未使用镜像，占用了宝贵的磁盘空间
2. 时区配置错误：docker-compose.yml 文件中存在错误的 TZ 环境变量语法

详细技术分析

磁盘空间问题

在 Linux 系统中，使用 df -h 命令检查磁盘使用情况时，发现根分区使用率已达100%。进一步使用 docker system df 命令检查 Docker 资源使用情况，显示存在大量未使用的镜像占用了超过16GB空间。

Docker 会保留旧版本的镜像，这些"孤儿镜像"会逐渐累积并占用大量磁盘空间。当磁盘空间耗尽时，PostgreSQL 数据库和其他关键服务将无法正常运行，导致 TeslaMate 和 Grafana 服务中断。

解决方案是定期执行 docker system prune 命令清理未使用的 Docker 资源。该命令可以回收大量磁盘空间，在上述案例中成功释放了18GB空间。

时区配置问题

在 docker-compose.yml 文件中，时区配置存在语法错误：

- TZ={$TM_TZ}  # 错误写法

正确的写法应该是：

- TZ=${TM_TZ}  # 正确写法

这个错误导致 TeslaMate 无法正确识别时区设置，在日志中会出现"time_zone_not_found"错误。虽然服务仍能启动，但可能导致时间相关功能异常。

其他相关建议

1. PostgreSQL 版本升级：建议将 PostgreSQL 从较旧的v12版本升级到v15，以获得更好的性能和稳定性
2. Docker 版本更新：确保使用较新版本的 Docker（如v26），避免已知兼容性问题
3. 定期维护：建立定期清理 Docker 资源和备份数据库的维护计划

问题解决效果

在修复磁盘空间问题和更正时区配置后，TeslaMate 服务已稳定运行超过4天，未再出现"Bad Gateway"错误。这表明上述解决方案有效解决了该问题。

总结

TeslaMate 服务异常往往由系统资源或配置问题引起。通过系统化的排查方法，包括检查磁盘空间、验证配置语法和保持软件更新，可以有效解决大多数运行问题。建议 TeslaMate 用户定期进行系统维护，以确保服务的长期稳定运行。