Spring Boot Docker镜像无法连接本地MariaDB问题求助

核心原因 #

Docker容器拥有独立网络空间，容器内的localhost指向容器自身，而非宿主机的MariaDB服务，这是连接被拒绝的核心原因。

具体解决步骤 #

1. 修改Spring Boot数据库连接地址 #

• Linux/macOS：将配置文件（如application.properties或application.yml）中的数据库主机从localhost改为宿主机内网IP，或使用Docker提供的特殊域名host.docker.internal（Docker Desktop支持）。
  示例配置：

  spring.datasource.url=jdbc:mariadb://host.docker.internal:3306/your_database_name
  spring.datasource.username=your_username
  spring.datasource.password=your_password
  

• Windows：同样使用host.docker.internal，或直接填写宿主机内网IP。

2. 允许MariaDB外部连接 #

• 修改MariaDB配置文件（通常路径为/etc/mysql/my.cnf或/etc/mysql/mariadb.conf.d/50-server.cnf），将bind-address设置为0.0.0.0（允许所有IP访问），或指定宿主机内网IP。
• 重启MariaDB服务：

  sudo systemctl restart mariadb
  

• 为数据库用户授权外部访问权限：

  GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_username'@'%' IDENTIFIED BY 'your_password';
  FLUSH PRIVILEGES;
  

  注：生产环境建议将%替换为具体IP范围，缩小访问权限。

3. 检查宿主机防火墙/安全组 #

• 确保宿主机3306端口未被防火墙拦截，以ufw为例开放端口：

  sudo ufw allow 3306/tcp
  

4. 验证网络通路 #

• 在容器内测试端口连通性：

  docker exec -it your_container_name telnet host.docker.internal 3306
  

  若连接成功，说明网络正常，问题出在应用配置或数据库权限。

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