EvolutionAPI在Docker部署中迁移失败的解决方案

问题背景

在使用Docker部署EvolutionAPI时，开发者遇到了数据库迁移失败的问题。错误日志显示在执行PostgreSQL迁移时出现了异常，导致API无法正常启动。

环境配置分析

从提供的配置来看，开发者使用了以下组件：

• EvolutionAPI作为主服务
• Redis作为缓存服务
• PostgreSQL作为数据库服务
• pgAdmin作为数据库管理界面

这些服务通过Docker Compose编排，并共享一个名为evolution-net的自定义网络。

关键问题发现

仔细检查配置后，发现EvolutionAPI服务容器缺少了网络配置。虽然其他服务(Redis、PostgreSQL、pgAdmin)都正确配置了evolution-net网络，但主服务evolution-api却没有加入这个网络。

解决方案

修改docker-compose.yml文件，为evolution-api服务添加网络配置：

services:
  evolution-api:
    container_name: evolution
    image: atendai/evolution-api:latest
    restart: always
    depends_on:
      - redis
      - postgres
    ports:
      - 8080:8080
    env_file:
      - .env
    volumes:
      - evolution_instances:/evolution/instances
    networks:  # 添加这部分网络配置
      - evolution-net

问题原因解析

当evolution-api容器没有加入同一网络时：

1. 容器间通信被隔离
2. 数据库连接字符串中的主机名"postgres"无法解析
3. 迁移过程无法连接到PostgreSQL服务
4. 最终导致迁移失败

配置验证要点

确保部署EvolutionAPI时注意以下配置：

1. 所有服务必须加入同一Docker网络
2. 数据库连接字符串中的主机名必须与容器名称一致
3. 环境变量DATABASE_CONNECTION_URI中的端口应与PostgreSQL服务暴露的端口匹配
4. 网络配置应在所有需要互通的容器中保持一致

最佳实践建议

1. 使用Docker Compose时，显式为所有服务配置网络
2. 对于数据库连接，建议先验证网络连通性
3. 部署前检查各服务的依赖关系
4. 使用docker network inspect命令验证网络配置
5. 考虑添加健康检查确保服务依赖顺序

总结

这个案例展示了在微服务架构中网络配置的重要性。即使是简单的遗漏，也可能导致关键功能失效。通过正确配置Docker网络，可以确保EvolutionAPI与其他服务正常通信，顺利完成数据库迁移过程。