Docker化SpringBoot项目时Maven Install无法连接MySQL容器

1. 宿主机无法解析Docker容器名：mysqldb是Docker网络内部的容器标识，只有处于同一Docker网络中的容器才能通过该名称解析到对应IP。而你在宿主机执行maven install时，宿主机的DNS系统无法识别这个容器名，自然无法建立连接。
2. Maven构建阶段触发了测试代码：如果你的项目在maven install过程中自动执行了单元测试/集成测试，测试代码会尝试连接数据库，此时使用容器名作为地址，宿主机无法定位到MySQL服务。

临时绕过（快速完成构建） #

执行Maven构建时跳过测试环节，避免在宿主机环境连接数据库：

mvn install -DskipTests

构建完成后，将SpringBoot项目打包为Docker镜像，并将其加入到之前创建的Docker网络中运行，此时容器内的应用就能通过mysqldb访问MySQL服务。

适配宿主机测试的方案 #

修改application.yml中的数据库地址为以下两种形式之一：

• 宿主机的实际IP地址（例如192.168.1.100），同时确保MySQL容器已经将3306端口映射到宿主机（启动容器时添加-p 3306:3306参数）。
• 使用Docker提供的宿主机内部别名host.docker.internal（适用于Windows/macOS Docker Desktop，Linux需额外配置），该地址会直接指向宿主机，从而连接到映射的MySQL端口。

标准化容器化方案（推荐） #

使用Docker Compose管理多容器环境，将SpringBoot应用和MySQL容器纳入同一配置：

1. 编写docker-compose.yml文件，定义两个服务并指定同一网络：

version: '3.8'
services:
  mysqldb:
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: your_password
      MYSQL_DATABASE: your_db
    networks:
      - app-network
  springboot-app:
    build: .
    ports:
      - "8080:8080"
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://mysqldb:3306/your_db?useSSL=false&serverTimezone=UTC
    networks:
      - app-network
networks:
  app-network:
    driver: bridge

2. 执行docker-compose up --build，即可同时启动MySQL和SpringBoot应用，此时应用能直接通过mysqldb访问数据库，无需在宿主机处理网络解析问题。

额外检查项 #

• 确认MySQL容器的bind-address配置为0.0.0.0（允许所有IP访问），默认情况下Docker版MySQL已配置此参数，但如果有自定义配置需验证。
• 确认MySQL容器确实加入了你创建的Docker网络，可通过docker inspect mysqldb查看网络信息。

内容的提问来源于stack exchange，提问作者Umut Emre Önder