解决Cognita项目中Docker容器连接PostgreSQL数据库失败的问题

问题背景

在部署Cognita项目时，用户遇到了Docker容器无法连接到PostgreSQL数据库的问题。具体表现为启动容器时出现错误信息"Error: P1001: Can't reach database server at host.docker.internal:5432"，表明后端服务无法访问配置的数据库服务器。

问题分析

这个问题的核心在于Docker容器间的网络通信配置。在Docker环境中，容器间的通信需要通过正确的服务名称或网络地址来实现。原始配置中使用了host.docker.internal作为数据库主机地址，这在某些Docker环境中可能无法正常工作，特别是在Linux系统上。

解决方案

1. 修改数据库连接配置

根据问题讨论，有效的解决方案是修改compose.env文件中的DOCKER_HOST配置：

• 将DOCKER_HOST=host.docker.internal改为DOCKER_HOST=db.cognita_cognita-docker
• 或者简化为DOCKER_HOST=db（在某些环境中有效）

这个修改确保了后端服务能够通过Docker内部网络正确访问PostgreSQL容器。

2. 处理后续配置文件问题

在解决数据库连接问题后，还可能出现另一个错误："FileNotFoundError: [Errno 2] No such file or directory: './models_config.json'"。这是因为项目需要特定的配置文件：

• 需要从示例文件创建实际配置文件：cp models_config.sample.yaml models_config.yaml
• 然后根据实际需求编辑这个文件，填入必要的API密钥等配置信息

3. 完整的部署步骤

基于最新的项目状态，完整的部署流程应该是：

1. 拉取最新代码
2. 创建配置文件
3. 重建并启动容器

git pull origin main
cp models_config.sample.yaml models_config.yaml
docker compose --env-file compose.env --profile '*' down
docker compose --env-file compose.env --profile '*' up -d --build

技术要点

1. Docker网络：理解Docker容器间的通信机制是关键。在Docker Compose中，服务可以通过服务名称相互访问，这是最可靠的连接方式。

2. 环境配置：项目配置通过环境变量和配置文件管理，需要确保这些文件存在且内容正确。

3. 依赖管理：项目使用Prisma作为ORM工具，需要正确配置数据库连接才能进行迁移和同步操作。

总结

部署Cognita项目时遇到的数据库连接问题主要源于Docker网络配置和项目文件准备不足。通过正确配置服务名称和确保所有必要文件存在，可以顺利解决这些问题。这反映了在容器化部署中理解网络配置和项目结构的重要性。