Docker Compose配置：JDBC连接从localhost改为mysql服务名

java.net.UnknownHostException: mysql报错的核心原因是：Docker Compose创建的服务域名仅对加入同一Docker私有网络的容器生效，进程如果跑在宿主机上、不在对应网络内，自然无法解析mysql这个主机名。

要实现本地、CI环境统一使用jdbc:mysql://mysql:3306/project作为数据库地址，优先用和CI逻辑完全对齐的容器化部署方案，配置如下：

同一份docker-compose.yml下定义的服务，默认会自动加入同一个私有网桥网络，服务之间天然可以通过服务名作为域名互访，不需要额外加网络配置。你只需要修正两处配置即可：

1. 对齐MySQL的环境变量配置，和JDBC连接参数匹配
2. 本地启动时不要在宿主机单独启动Tomcat/应用进程，直接通过compose拉起所有服务

修正后的docker-compose.yml内容：

version: '3.3'
services:
  tomcat:
    image: tomcat:9-jre11
    volumes:
      - ./target:/usr/local/tomcat/webapps
    ports:
      - "8080:8080"
    depends_on:
      - mysql
  mysql:
    image: mysql:latest
    environment:
      MYSQL_USER: mysql_user
      MYSQL_PASSWORD: mysql_password
      MYSQL_ROOT_PASSWORD: mysql_root_password
      # 原配置库名和JDBC里的project不一致，必须修正
      MYSQL_DATABASE: project
    ports:
      - "3306:3306"

操作步骤：

• 项目打包完成后，在docker-compose.yml所在目录执行docker-compose up -d即可启动所有服务
• Tomcat容器和MySQL容器在同一网络内，可直接通过mysql:3306建立连接，不需要修改任何JDBC配置，和CI环境运行逻辑完全一致
• 注意：depends_on仅控制容器启动顺序，不会等待MySQL完成初始化，如果首次启动报连接错误，等待10-20秒重启Tomcat容器即可，也可以通过添加healthcheck配置实现服务就绪判断。

如果本地调试时需要直接在宿主机启动应用、不使用compose里的Tomcat容器，可以通过修改宿主机hosts文件实现域名解析：

1. 先启动MySQL容器：docker-compose up -d mysql
2. 执行命令查询MySQL容器的内网IP：
   docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' $(docker ps -qf "name=mysql")
3. 修改宿主机hosts文件：
   • Linux/macOS路径：/etc/hosts
   • Windows路径：C:\Windows\System32\drivers\etc\hosts
     在文件末尾添加一行记录，将mysql域名指向刚才查到的容器IP：

   <查询到的MySQL容器IP> mysql
   

4. 配置生效后，宿主机上的应用就可以通过jdbc:mysql://mysql:3306/project正常连接数据库。该方案的缺点是MySQL容器销毁重建后内网IP会变化，需要重新更新hosts记录。

避坑提示：如果域名解析正常但仍连接失败，优先检查MySQL的用户名、密码、库名配置是否和JDBC参数完全匹配，原配置中MYSQL_DATABASE设为mysql_database，和JDBC里的project库不匹配，会直接报库不存在错误。

内容的提问来源于stack exchange，提问作者Harald