TeslaMate 项目中使用 PostgreSQL 16 解决 "earth" 类型不存在问题

问题背景

TeslaMate 是一款开源的 Tesla 车辆数据记录和可视化工具，它使用 PostgreSQL 数据库存储车辆数据。近期用户在部署最新版本时遇到了一个数据库迁移错误，提示 "type 'earth' does not exist"。

错误现象

当用户尝试启动 TeslaMate 容器时，数据库迁移过程中会出现以下关键错误：

2024-10-20 23:41:16.516 [info] create index geofences__earth_box_ll_to_earth_latitude__longitude___radius_index
** (Postgrex.Error) ERROR 42704 (undefined_object) type "earth" does not exist

这个错误发生在创建地理空间索引时，系统无法识别 PostgreSQL 中的 "earth" 数据类型。

问题根源

经过分析，这个问题源于：

1. TeslaMate 使用了 PostgreSQL 的 earthdistance 扩展来计算地理距离
2. 最新版本的 PostgreSQL 17 中可能修改了相关扩展的实现方式
3. 数据库迁移脚本假设了特定版本的 PostgreSQL 行为

解决方案

官方确认这是一个版本兼容性问题，并提供了明确的解决方案：

1. 使用 PostgreSQL 16 版本：这是当前稳定兼容的版本
2. 清理旧数据库卷：如果是全新安装，需要删除旧的数据库卷

具体操作步骤：

docker volume rm "$(basename "$PWD")_teslamate-db"

然后重新部署使用 PostgreSQL 16 的 TeslaMate 实例。

后续处理

在 v1.31.0 版本中，TeslaMate 团队已经修复了这个问题。对于遇到此问题的用户，可以：

1. 等待升级到 v1.31.0 或更高版本
2. 暂时使用 PostgreSQL 16 作为临时解决方案

技术细节

earthdistance 是 PostgreSQL 的一个扩展，它提供了基于地球表面计算距离的功能。这个扩展依赖于 cube 扩展，并引入了 "earth" 数据类型来表示地球表面上的点。在 PostgreSQL 17 中，这个扩展的实现可能发生了变化，导致 TeslaMate 的迁移脚本失效。

用户建议

1. 在部署 TeslaMate 时，注意检查 PostgreSQL 版本兼容性
2. 遇到数据库迁移问题时，可以尝试清理旧数据库卷重新开始
3. 关注 TeslaMate 的版本更新，及时升级到修复版本

这个问题展示了开源项目中版本依赖管理的重要性，也提醒我们在使用容器化部署时要特别注意各个组件之间的版本兼容性。