本文旨在解决Spring Boot应用在Docker容器中无法连接MySQL数据库的常见问题。核心症结在于Docker网络环境下，应用程序应使用数据库服务的名称而非`localhost`进行连接。教程将详细阐述这一原理，并提供正确的`docker-compose.yml`配置示例，确保Spring应用与MySQL数据库在Docker网络中顺利通信。
Spring Boot应用在Docker中连接MySQL的正确实践
在将Spring Boot应用和MySQL数据库容器化部署时，一个常见的连接问题是应用程序无法正确解析数据库主机名。这通常是由于在Docker Compose环境中，服务之间的通信机制与传统本地开发环境有所不同。本文将深入探讨这个问题，并提供一个结构清晰的解决方案。
问题分析：为什么localhost不起作用？
当Spring Boot应用运行在一个Docker容器内时，它拥有自己的独立网络环境。在这个容器内部，localhost或127.0.0.1始终指向该容器自身。因此，如果你的Spring应用尝试通过jdbc:mysql://localhost:3306/...连接MySQL，它实际上是在尝试连接自己容器内部的3306端口，而不是运行在另一个Docker容器中的MySQL服务。
在Docker Compose定义的网络中，每个服务（如sample-service和mysqldb）都被分配一个虚拟IP地址，并且它们可以通过各自的服务名称进行相互访问。Docker Compose的内置DNS解析器会将服务名称解析为其对应的容器IP地址。
原始的docker-compose.yml配置中，sample-service的SPRING_DATASOURCE_URL配置如下：
SPRING_DATASOURCE_URL: jdbc:mysql://localhost:3306/buddyto_mstr_local?useSSL=false
这里的关键错误在于使用了localhost。
ECTouch是上海商创网络科技有限公司推出的一套基于 PHP 和 MySQL 数据库构建的开源且易于使用的移动商城网店系统！应用于各种服务器平台的高效、快速和易于管理的网店解决方案，采用稳定的MVC框架开发，完美对接ecshop系统与模板堂众多模板，为中小企业提供最佳的移动电商解决方案。ECTouch程序源代码完全无加密。安装时只需将已集成的文件夹放进指定位置，通过浏览器访问一键安装，无需对已有
解决方案：使用服务名称进行连接
正确的做法是，在Spring应用的SPRING_DATASOURCE_URL中，将localhost替换为MySQL服务的名称。根据提供的docker-compose.yml，MySQL服务的名称是mysqldb。
1. 修改SPRING_DATASOURCE_URL
将Spring应用的数据库连接URL修改为：
SPRING_DATASOURCE_URL: jdbc:mysql://mysqldb:3306/buddyto_mstr_local?useSSL=false
修改后的docker-compose.yml片段应如下所示：
version: "3"
services:
sample-service:
image: v2stechit/sample-service
ports:
- "8080:8080"
restart: always
environment:
# 将 localhost 替换为 MySQL 服务的名称 'mysqldb'
SPRING_DATASOURCE_URL: jdbc:mysql://mysqldb:3306/buddyto_mstr_local?useSSL=false
SPRING_DATASOURCE_USERNAME: root
SPRING_DATASOURCE_PASSWORD: root
networks:
- spring-mysql
depends_on:
- mysqldb
mysqldb:
image: mysql:8.0.29
networks:
- spring-mysql
environment:
- MYSQL_ROOT_PASSWORD=root
- MYSQL_DATABASE=buddyto_mstr_local
- MYSQL_USERNAME=root
- MYSQL_PASSWORD=root
ports:
- 3306:3306
networks:
spring-mysql:2. 理解Docker Compose网络配置
- networks: - spring-mysql: 这两项服务都被配置在同一个名为spring-mysql的自定义网络中。这是它们能够通过服务名称相互通信的基础。
- depends_on: - mysqldb: sample-service的depends_on指令确保mysqldb服务在sample-service启动之前就已经运行。这有助于避免因数据库尚未完全启动而导致的连接失败。然而，需要注意的是，depends_on只保证启动顺序，不保证数据库内部服务（如初始化完成、监听连接）已就绪。对于生产环境，更健壮的健康检查机制可能更合适。
额外注意事项与最佳实践
- 数据库初始化时间: 尽管depends_on确保了启动顺序，但MySQL容器可能需要几秒钟来完全初始化并准备好接受连接。Spring Boot应用在启动时可能会尝试连接数据库。如果MySQL尚未就绪，应用仍可能报错。可以考虑在Spring应用中配置重试机制，或者使用更高级的健康检查来确保数据库服务完全可用后再启动应用。
- useSSL=false: 在开发或测试环境中，为了简化配置并避免SSL证书问题，通常会在JDBC URL中添加?useSSL=false。在生产环境中，强烈建议配置和使用SSL来加密数据库连接。
-
端口映射:
- sample-service的ports: - "8080:8080"表示将容器的8080端口映射到主机的8080端口，这样你就可以通过http://localhost:8080从主机访问Spring应用。
- mysqldb的ports: - 3306:3306表示将容器的3306端口映射到主机的3306端口。虽然Spring应用通过服务名称连接MySQL时不需要这个映射，但它允许你从主机上的MySQL客户端工具（如DataGrip, MySQL Workbench）直接连接到Docker容器中的MySQL数据库，便于调试和管理。
-
日志检查: 在遇到连接问题时，始终检查两个容器的日志：
- Spring应用容器的日志会显示JDBC连接错误信息。
- MySQL容器的日志会显示数据库是否正常启动，是否监听在3306端口，以及是否有任何权限或网络相关的错误。
总结
在Docker Compose环境中部署Spring Boot应用和MySQL数据库时，核心原则是利用Docker的内部网络和DNS解析机制。通过将数据库连接URL中的localhost替换为MySQL服务的名称（例如mysqldb），可以确保Spring应用能够正确地解析并连接到运行在另一个容器中的MySQL数据库。遵循这些实践将有助于构建稳定可靠的容器化应用程序栈。
