JeecgBoot Docker部署常见问题解析

Question

**问题：JeecgBoot 在 Docker 容器中启动时出现数据库连接失败，应如何排查与解决？** 在使用 Docker 部署 JeecgBoot 项目时，常遇到应用启动时报数据库连接失败的问题。可能原因包括数据库容器未启动、网络配置错误、数据库连接参数配置不当等。建议从以下几个方面进行排查：检查数据库容器是否正常运行；确认 JeecgBoot 容器与数据库容器是否处于同一 Docker 网络中；检查 application.yml 中的数据库连接地址、端口、用户名和密码是否正确；确保宿主机或云服务器的防火墙未阻挡数据库端口。通过日志分析和容器间网络互通测试，有助于快速定位问题根源。

Answer 1

JeecgBoot 在 Docker 容器中启动时出现数据库连接失败的排查与解决方案

1. 初步排查：确认数据库容器是否正常运行

首先检查数据库容器是否处于运行状态：

docker ps

如果未看到数据库容器（如 MySQL 或 PostgreSQL），请查看其状态：

docker ps -a

若状态为 Exited，可尝试启动容器或查看其日志信息：

docker logs [数据库容器名或ID]

2. 网络配置检查：容器间是否处于同一网络

JeecgBoot 容器与数据库容器需处于同一 Docker 自定义网络中。可通过以下命令查看容器所属网络：

docker inspect [容器名或ID] | grep NetworkName

建议使用 Docker Compose 统一编排服务，确保网络互通。示例 docker-compose.yml 片段如下：

version: '3'
services:
  jeecgboot:
    image: jeecgboot:latest
    networks:
      - app-network
  mysql:
    image: mysql:5.7
    networks:
      - app-network
networks:
  app-network:
    driver: bridge

3. 数据库连接参数配置检查

进入 JeecgBoot 容器内部，检查 application.yml 文件中的数据库连接配置：

docker exec -it jeecgboot_container_id /bin/bash
cat application.yml | grep datasource

确保配置中的地址、端口、用户名、密码、数据库名与数据库容器一致。例如：

url: jdbc:mysql://mysql:3306/jeecg?useUnicode=true&characterEncoding=UTF-8

注意：数据库地址应为容器名，而非 localhost 或 127.0.0.1。

4. 网络互通测试：容器间是否能通信

进入 JeecgBoot 容器，尝试使用 telnet 或 nc 测试数据库端口是否可达：

docker exec -it jeecgboot_container_id /bin/bash
apt update && apt install net-tools iproute2 telnet -y
telnet mysql 3306

若连接失败，说明网络配置存在问题，需重新检查 Docker 网络设置。

5. 防火墙与端口开放检查

若数据库运行在宿主机或远程服务器上，需确保防火墙允许外部访问数据库端口（如 3306）：

sudo ufw status
sudo ufw allow 3306

在云服务器上，还需检查安全组规则，确保数据库端口对容器所在网络开放。

6. 日志分析：定位具体错误信息

查看 JeecgBoot 容器启动日志，定位数据库连接失败的具体原因：

docker logs jeecgboot_container_id

典型错误信息包括：

• java.net.UnknownHostException: mysql —— DNS 解析失败，网络不通
• Connection refused —— 数据库未启动或端口未开放
• Access denied for user —— 用户名或密码错误

7. 进阶排查：使用 Docker Compose 一键部署

推荐使用 Docker Compose 编排多个服务，简化部署与调试过程。以下是一个完整的 docker-compose.yml 示例：

version: '3'
services:
  jeecgboot:
    image: jeecgboot:latest
    ports:
      - "8080:8080"
    environment:
      - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/jeecg?useUnicode=true&characterEncoding=UTF-8
      - SPRING_DATASOURCE_USERNAME=root
      - SPRING_DATASOURCE_PASSWORD=123456
    depends_on:
      - mysql
    networks:
      - app-network

  mysql:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: 123456
      MYSQL_DATABASE: jeecg
    ports:
      - "3306:3306"
    volumes:
      - mysql_data:/var/lib/mysql
    networks:
      - app-network

volumes:
  mysql_data:

networks:
  app-network:
    driver: bridge

8. 常见问题总结与建议

问题现象	可能原因	解决建议
UnknownHostException	容器网络不通或服务名错误	检查容器网络、服务名、DNS 解析
Connection refused	数据库未启动或端口未暴露	启动数据库容器、检查端口映射与防火墙
Access denied	用户名或密码错误	检查数据库配置与权限设置
Connection timeout	网络延迟或数据库响应慢	优化网络环境或调整连接超时参数

9. 进一步建议：使用健康检查机制

为确保 JeecgBoot 容器在数据库容器就绪后再启动，可在 Docker Compose 中配置健康检查：

healthcheck:
  test: ["CMD", "curl", "-f", "http://mysql:3306"]
  interval: 5s
  timeout: 2s
  retries: 5

或使用 depends_on + condition 配置：

depends_on:
  mysql:
    condition: service_healthy

10. 可视化流程图：数据库连接失败排查流程

以下是数据库连接失败排查的流程图示意：

graph TD
            A[启动 JeecgBoot 容器] --> B{数据库容器是否运行?}
            B -->|否| C[启动数据库容器]
            B -->|是| D{网络是否互通?}
            D -->|否| E[配置 Docker 网络]
            D -->|是| F{连接参数是否正确?}
            F -->|否| G[修改 application.yml 配置]
            F -->|是| H{端口是否开放?}
            H -->|否| I[开放防火墙或安全组]
            H -->|是| J{日志是否有异常?}
            J -->|有| K[根据日志定位具体错误]
            J -->|无| L[应用启动成功]