本文档旨在帮助开发者解决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）
- 确保数据库连接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());
}
}
}注意事项
- 在生产环境中，应使用更安全的密码管理方法，例如使用环境变量或密钥管理服务。
- 定期更新MySQL镜像以获取最新的安全补丁。
- 监控容器的资源使用情况，并根据需要调整资源限制。
总结
通过仔细检查Docker Compose文件、Java应用的配置文件和MySQL配置，可以解决Docker容器中Java应用连接MySQL数据库的问题。确保端口映射、数据库连接URL和网络配置正确，是成功连接的关键。
