Docker容器无法连接本地MySQL，多种方案尝试无效求帮助

嘿，我之前也踩过Docker容器连本地MySQL的坑，咱们一步步来排查你遇到的问题：

1. 先搞懂容器里的localhost不是宿主机的localhost #

Docker默认的bridge网络下，容器里的localhost指向的是容器自己，不是你的Ubuntu宿主机。这是最容易踩的坑！解决办法有两个：

• 用宿主机的内网IP：在Ubuntu终端里用ip addr查一下你的内网IP（比如192.168.1.100这种），然后把JDBC连接里的localhost换成这个IP。
• 共享宿主机网络：启动容器的时候加上--network host参数，这样容器会直接用宿主机的网络，容器里的localhost就和宿主机的一致了。不过这个方法会失去容器的网络隔离性，适合测试场景。

2. 检查MySQL是否允许外部访问 #

默认情况下，MySQL可能只监听本地回环接口，容器根本连不上：

• 打开MySQL配置文件（通常是/etc/mysql/mysql.conf.d/mysqld.cnf），找到bind-address这行：
  • 如果是127.0.0.1，改成0.0.0.0（允许所有IP访问），或者改成你的宿主机内网IP。
• 修改完重启MySQL：sudo systemctl restart mysql

3. 确认MySQL用户有远程访问权限 #

就算MySQL允许外部访问，你的账号可能只能在本地登录：

• 登录MySQL，执行下面的SQL（把your_user、your_password、your_db换成你的实际信息）：

  CREATE USER 'your_user'@'%' IDENTIFIED BY 'your_password';
  GRANT ALL PRIVILEGES ON your_db.* TO 'your_user'@'%';
  FLUSH PRIVILEGES;
  

  这里的%表示允许这个账号从任何IP访问，如果你想更安全，可以换成Docker容器所在的子网（比如默认bridge子网是172.17.0.0/16）。

4. 检查Ubuntu防火墙是否拦截了3306端口 #

Ubuntu的ufw防火墙可能会阻止容器访问MySQL的3306端口：

• 先看防火墙状态：sudo ufw status
• 如果3306端口没开放，添加规则：sudo ufw allow 3306，或者更精准一点：sudo ufw allow from 172.17.0.0/16 to any port 3306

5. 针对MySQL 8.x连接器的细节优化 #

你用的是mysql-connector-java 8.0.9-rc，这个版本有几个必须注意的点：

• JDBC连接字符串必须指定时区，还要加上allowPublicKeyRetrieval=true（因为8.x默认用caching_sha2_password认证），比如：

  jdbc:mysql://<你的宿主机IP>:3306/your_db?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
  

• 驱动类名要改成com.mysql.cj.jdbc.Driver，旧的com.mysql.jdbc.Driver已经被废弃了，虽然新版本可能兼容，但明确指定更稳妥。

如果按照上面的步骤排查完还是不行，建议把抛出的具体异常信息贴出来，比如是连接超时还是认证失败，这样能更快定位问题。

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