Dawarich项目升级后数据库健康检查问题解决方案

问题背景

Dawarich项目在最新版本0.23.6更新后，部分用户遇到了服务无法正常运行的问题。主要表现为应用容器(dawarich_app)的健康检查失败，以及数据库容器(dawarich_db)的健康状态异常。这些问题主要源于项目从PostgreSQL迁移到了PostGIS数据库，以及版本兼容性变化。

核心问题分析

1. 数据库版本兼容性问题

原配置中使用的是PostgreSQL 17-alpine镜像，但新版本Dawarich要求数据库必须支持PostGIS扩展功能。这是导致数据库健康检查失败的根本原因。

2. 健康检查机制

Dawarich应用的健康检查通过API端点/api/v1/health进行验证，当数据库连接异常时会导致检查失败。而数据库本身的健康检查使用pg_isready命令，在缺少必要扩展时会返回不健康状态。

解决方案

数据库镜像替换

将原配置中的：

image: postgres:17-alpine

替换为：

image: postgis/postgis:17-3.5-alpine

这个官方PostGIS镜像已经预装了所有必要的空间数据库扩展，完全兼容Dawarich的新版本需求。

数据库用户权限调整

对于从旧版本迁移的用户，可能需要为数据库用户授予超级用户权限：

ALTER ROLE dawarich SUPERUSER;

应用配置调整

1. 健康检查重试策略：适当增加健康检查的重试次数和间隔，给数据库和应用足够的启动时间。

2. 主机访问控制：确保APPLICATION_HOSTS配置包含所有可能的访问地址，避免出现"Blocked hosts"错误。

3. 启动顺序优化：建议先启动应用容器完成数据库迁移，再启动Sidekiq工作进程。

实施步骤

1. 备份现有数据库数据
2. 更新docker-compose.yml中的数据库镜像配置
3. 重建数据库容器
4. 恢复备份数据
5. 按顺序启动应用容器和Sidekiq容器
6. 验证各服务健康状态

经验总结

1. 在升级前务必检查版本变更说明，特别是可能引入的破坏性变更
2. 数据库迁移操作应在低峰期进行，并确保有完整的备份
3. 监控系统日志可以帮助快速定位启动过程中的问题
4. 分阶段验证服务健康状态比一次性启动所有容器更可靠

通过以上调整，Dawarich项目可以顺利完成版本升级并保持稳定运行。对于使用外部PostgreSQL实例的用户，需要确保实例已启用PostGIS扩展，或考虑迁移到专用的PostGIS容器。