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

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

问题分析

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

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

解决方案

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

1. 检查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

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

   • 确保数据库连接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

3. 验证MySQL配置

   

   OmniAudio

   OmniAudio 是一款通过 AI 支持将网页、Word 文档、Gmail 内容、文本片段、视频音频文件都转换为音频播客，并生成可在常见 Podcast ap

   68

   查看详情

   • 确保MySQL服务器允许来自其他容器的连接。 在MySQL容器中，您可能需要执行以下命令来允许来自任何主机的连接：

   GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'pass'; FLUSH PRIVILEGES;

   注意： 在生产环境中，不建议允许来自任何主机的连接。 应限制为仅允许来自应用容器的连接。

4. 检查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());         }     } }

注意事项

• 在生产环境中，应使用更安全的密码管理方法，例如使用环境变量或密钥管理服务。
• 定期更新MySQL镜像以获取最新的安全补丁。
• 监控容器的资源使用情况，并根据需要调整资源限制。

总结

通过仔细检查Docker Compose文件、Java应用的配置文件和MySQL配置，可以解决Docker容器中Java应用连接MySQL数据库的问题。确保端口映射、数据库连接URL和网络配置正确，是成功连接的关键。