Docker容器内Spring Boot JPA连接外部本地MySQL失败求助

Hey there! I totally get where you're coming from—when you're new to Docker, it's easy to trip up on network quirks like this. Let's break down why your container can't reach localhost:3306 and fix it step by step.

问题根源 #

Inside a Docker container, localhost refers to the container's own network stack, not your host machine. So when your Spring Boot app tries to connect to localhost:3306, it's looking for a MySQL instance inside the container (which doesn't exist), hence the communications link failure you're seeing.

解决方案 #

We need to point your Spring Boot app to your host machine's actual network address instead of localhost. Here's how to do it based on your operating system:

1. 适用于Windows或macOS（Docker Desktop环境） #

Docker Desktop提供了一个特殊的DNS名称 host.docker.internal，它会直接解析到你的宿主机。只需修改你的application.properties配置：

spring.datasource.url=jdbc:mysql://host.docker.internal:3306/mydatabase?useSSL=false
spring.datasource.username=root
spring.datasource.password=password
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

2. 适用于Linux系统 #

Linux版Docker默认没有host.docker.internal这个解析，但你可以在启动容器时手动添加映射：

• 启动容器时带上这个参数，把宿主机网关映射到容器内的host.docker.internal：

  docker run -p 8080:8080 --add-host=host.docker.internal:host-gateway your-springboot-image-name
  

• 之后同样在application.properties里使用host.docker.internal，或者直接用你宿主机的局域网IP（比如192.168.1.100，可以通过ip a命令查询）。

3. 关键MySQL配置检查 #

即使你修改了数据库URL，MySQL可能还会阻止容器的连接请求，请确认以下两点：

• 你的MySQL配置文件（my.cnf或my.ini）中，bind-address设置为0.0.0.0（而不是127.0.0.1），允许远程连接。
• 给root用户授权从非localhost地址访问数据库：

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

  （把password替换成你实际的MySQL root密码）

验证步骤 #

1. 使用更新后的application.properties重新构建Spring Boot Docker镜像。
2. 按对应系统的要求启动容器。
3. 测试你的REST接口——现在应该能成功连接到宿主机上的MySQL实例了。

对应你的错误日志 #

你日志里的CommunicationsException正好印证了这个问题：驱动无法向服务器发送数据包，因为它指向了错误的localhost（容器自身而非宿主机）。修改数据库URL就能解决这个问题。

内容的提问来源于stack exchange，提问作者Molay