本地Scala代码连接Docker内MySQL出现超时或连接拒绝错误如何解决

错误原因 #

• 最核心的错误是JDBC URL端口配置错误：你启动容器时配置的端口映射规则是3306:3306，本地终端连接也是用的3306端口，但Scala代码中所有JDBC URL的端口都写成了3006，端口不匹配直接导致连接失败。
• root用户授权规则不合理：你执行了update mysql.user set host = '127.0.0.1' where user='root';，该配置限制root用户只能从容器内部的127.0.0.1地址登录，后续如果需要从其他IP（包括宿主机的Docker网关地址、其他容器IP）访问，需要调整授权规则。
• 跨系统Docker网络限制：Windows、Mac系统的Docker Desktop默认不支持直接通过容器内部IP（172.17.0.2这类Docker内网地址）访问容器，只有Linux宿主机支持该访问方式，非Linux系统只能通过127.0.0.1+映射端口的方式访问容器服务。

修复步骤 #

1. 修正JDBC URL的端口，将3006改为3306，使用127.0.0.1访问的话推荐添加高版本MySQL适配参数，示例如下：

val url = "jdbc:mysql://127.0.0.1:3306/mysql?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC"

2. 调整root用户授权规则，进入MySQL容器执行以下SQL命令：

-- 允许root用户从任意地址登录，也可以将%替换为指定访问IP做权限收敛
update mysql.user set host = '%' where user='root';
flush privileges;

3. 确认项目依赖的MySQL JDBC驱动版本和容器内MySQL大版本匹配：如果容器使用MySQL 8.x版本，驱动也需要使用8.x版本的mysql-connector-java，避免兼容性报错。

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