Planka项目部署中数据库连接错误的排查与解决

问题现象

在Docker环境中部署Planka项目管理工具时，系统启动失败并抛出错误信息"getaddrinfo ENOTFOUND base"。该错误表明系统在尝试解析主机名时失败，导致服务无法正常启动。

错误分析

通过日志分析可以发现几个关键点：

1. 错误类型为ENOTFOUND，属于DNS解析失败
2. 系统尝试解析的主机名为"base"
3. 错误发生在Node.js的dns模块中

根本原因

深入检查后发现，问题并非出在BASE_URL配置上，而是由于DATABASE_URL参数配置不当导致的。常见的错误认知是认为getaddrinfo错误与BASE_URL有关，但实际上：

1. DATABASE_URL使用了错误的协议前缀"planka_postgres://"，正确应为"postgresql://"
2. 主机名指定为"postgres"而非容器名称"planka_postgres"
3. 这种配置导致系统尝试解析不存在的数据库主机

解决方案

修正DATABASE_URL的配置格式：

DATABASE_URL=postgresql://postgres@planka_postgres/planka

配置要点说明：

• 协议部分必须使用标准的postgresql
• 主机名需与PostgreSQL服务容器名称一致
• 数据库名称保持planka不变

部署建议

1. 网络配置：确保Docker容器间网络通信正常
2. 健康检查：保留原有的PostgreSQL健康检查配置
3. 环境隔离：建议为数据库设置独立密码而非使用trust认证
4. 连接测试：部署后可通过命令行工具测试数据库连接性

经验总结

在容器化部署中，服务发现和连接配置需要特别注意：

• 容器间通信应使用Docker内部DNS解析
• 协议前缀必须符合标准格式
• 主机名需与容器命名一致
• 错误日志分析要抓住关键线索

通过正确配置数据库连接参数，Planka项目可以顺利启动并提供服务。这个问题也提醒我们，在微服务架构中，服务发现和连接配置的准确性至关重要。