Docker容器JDBC连MySQL异常，需Workbench连接后恢复的问题排查

让我帮你一步步梳理这个JDBC连接Docker内MySQL的问题——这类故障大多和网络地址配置、容器启动时序或者连通性有关，咱们逐个击破：

1. 彻底修正JDBC URL里的localhost问题 #

这是Docker环境里最常见的坑！如果你的应用是跑在Docker容器中（哪怕是和MySQL同个docker-compose栈里），localhost指向的是应用容器自身的环回地址，不是宿主机上的MySQL容器。哪怕应用跑在宿主机，有些环境下localhost也会有解析问题，所以必须换掉：

• 如果应用和MySQL在同一个docker-compose网络：直接用服务名database作为主机名，URL改成：

  jdbc:mysql://database:3306/data?autoReconnect=true&useSSL=false
  

  Docker Compose会自动为同网络的容器做DNS解析，服务名就是容器的可访问地址。
• 如果应用跑在宿主机：用宿主机的实际IP（比如192.168.1.100）或者host.docker.internal（Docker Desktop专属，指向宿主机），别用localhost/127.0.0.1。

2. 解决MySQL容器启动就绪的时序问题 #

你提到首次docker-compose up时Workbench连不上，down再start就正常——这几乎可以确定是MySQL容器还没完成初始化就被你尝试连接了。MySQL镜像启动时会先执行挂载的data.sql初始化数据库，这个过程需要时间，不是容器一启动就可以连接的。

• 给docker-compose.yml的database服务加上健康检查，确保MySQL真正就绪后再对外提供服务：

  services:
    database:
      container_name: data
      image: mysql
      volumes:
        - ./data.sql:/docker-entrypoint-initdb.d/data.sql
      ports:
        - "3306:3306"
      environment:
        MYSQL_DATABASE: "data"
        MYSQL_USER: "user"
        MYSQL_PASSWORD: "pass"
        MYSQL_ROOT_PASSWORD: "root"
      # 新增健康检查
      healthcheck:
        test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-uuser", "-ppass"]
        interval: 5s
        timeout: 5s
        retries: 5
  

• 如果你的应用也在docker-compose里，给应用服务加上依赖健康状态的配置，避免提前发起连接：

  your-app-service:
    # 你的应用配置
    depends_on:
      database:
        condition: service_healthy
  

3. 验证端口映射与网络连通性 #

• 先用docker ps确认MySQL容器的3306端口是否成功映射到宿主机，避免端口冲突（比如宿主机本身跑了MySQL占用3306）。
• 在宿主机执行telnet localhost 3306或nc -zv localhost 3306，测试端口是否能连通——首次up时如果不通，说明MySQL还在初始化，等10-20秒再试。
• 如果应用在容器里，进入应用容器执行ping database或telnet database 3306，验证DNS解析和容器间的连通性是否正常。

4. 检查JDBC驱动与URL参数兼容性 #

• 你用的com.mysql.jdbc.Driver是适配MySQL 5.x的旧驱动，如果你的MySQL镜像是8.x版本，建议换成com.mysql.cj.jdbc.Driver，同时URL加上时区参数避免连接失败：

  jdbc:mysql://database:3306/data?autoReconnect=true&useSSL=false&serverTimezone=UTC
  

• autoReconnect=true只是重试机制，核心还是要解决连接不上的根本问题，不要依赖它掩盖故障。

内容的提问来源于stack exchange，提问作者G-man