Docker容器中Java 11应用连接MySQL 8数据库失败问题排查与解决

聖光之護

发布时间：2025-09-17 21:44:00

771人浏览过

来源于php中文网

原创

docker容器中java 11应用连接mysql 8数据库失败问题排查与解决

本文档旨在帮助开发者解决Docker容器中运行的Java 11应用无法连接到MySQL 8数据库的问题。通过分析常见的配置错误，例如端口映射和数据库连接URL配置，提供详细的排查步骤和解决方案，确保应用能够成功连接到数据库。

问题分析

在Docker容器中部署Java应用并连接MySQL数据库时，可能会遇到连接被拒绝的问题。这通常是由于以下几个原因造成的：

端口映射错误： Docker Compose文件中定义的端口映射只影响宿主机与容器之间的通信，容器内部服务之间的通信应使用容器内部端口。
数据库连接URL配置错误： Java应用中的数据库连接URL必须指向MySQL容器的内部服务名和端口。
网络配置问题： 确保应用和数据库容器在同一个Docker网络中，以便它们可以相互发现。
MySQL配置问题： MySQL服务器可能未配置为允许来自其他容器的连接。

解决方案

以下步骤将帮助您诊断和解决Docker容器中Java应用连接MySQL数据库的问题：

检查Docker Compose文件（docker-compose.yml）

立即学习“Java免费学习笔记（深入）”；

确保Java应用（server）和MySQL数据库（mysqldb）容器都位于同一个网络（app-network）中。
验证MySQL容器的端口映射是否正确。ports 部分定义了宿主机端口到容器端口的映射，但容器内部服务之间的通信应使用容器内部端口。

version: '3.8'

services:
  server:
    container_name: movies-app
    build: .
    restart: always
    ports:
      - "8088:8080"
    networks:
      - app-network

  mysqldb:
    container_name: mysqldb
    image: mysql:8.0.28
    restart: always
    ports:
      - "3307:3306"
    environment:
      MYSQL_DATABASE: moviesdb
      MYSQL_USER: user
      MYSQL_PASSWORD: pass
      MYSQL_ROOT_USER: root
      MYSQL_ROOT_PASSWORD: pass
    volumes:
      - dbdata:/var/lib/mysql
    networks:
      - app-network

networks:
  app-network:
    driver: bridge

volumes:
  dbdata:
    driver: local

检查Java应用的配置文件（application.yml）

稿定AI绘图
稿定推出的AI绘画工具

下载
- 确保数据库连接URL指向MySQL容器的服务名（mysqldb）和容器内部端口（3306）。不要使用映射到宿主机的端口（3307）。
```
spring:
  datasource:
    password: pass
    driver-class-name: com.mysql.cj.jdbc.Driver
    username: root
    url: jdbc:mysql://mysqldb:3306/moviesdb?createDatabaseIfNotExist=true&allowPublicKeyRetrieval=true&useSSL=false
```
验证MySQL配置
- 确保MySQL服务器允许来自其他容器的连接。在MySQL容器中，您可能需要执行以下命令来允许来自任何主机的连接：
```
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'pass';
FLUSH PRIVILEGES;
```
注意： 在生产环境中，不建议允许来自任何主机的连接。应限制为仅允许来自应用容器的连接。
检查Dockerfile
- 确保Dockerfile中安装了正确的JDK版本。虽然问题描述中提到了Java版本，但Dockerfile中存在多个FROM指令，这可能导致最终使用的JDK版本不正确。建议只保留一个FROM指令，并确保该指令指向正确的JDK版本。
- 移除不必要的mvn clean install 命令。该命令通常用于构建项目，但在Docker环境中，通常在构建镜像之前完成。
```
FROM maven:3.8.1-openjdk-11

COPY target/*.jar app.jar

EXPOSE 8088
ENTRYPOINT ["java", "-jar", "-Dspring.profiles.active=docker", "app.jar"]
```

示例代码

以下是一个简化的Java应用示例，用于测试与MySQL数据库的连接：

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

public class DatabaseConnector {

    public static void main(String[] args) {
        String url = "jdbc:mysql://mysqldb:3306/moviesdb?createDatabaseIfNotExist=true&allowPublicKeyRetrieval=true&useSSL=false";
        String user = "root";
        String password = "pass";

        try (Connection connection = DriverManager.getConnection(url, user, password)) {
            System.out.println("Successfully connected to the database!");
        } catch (SQLException e) {
            System.err.println("Failed to connect to the database: " + e.getMessage());
        }
    }
}