容器化SpringBoot应用无法连接现有MySQL容器的问题排查

问题1：避免Compose创建新MySQL容器与现有容器冲突 #

直接移除compose.yml中定义的mysql服务块——你已经有运行中的MySQL容器，不需要Compose再创建新实例。接下来把现有运行的mysql-db容器加入到Compose配置的my_network网络，执行命令：

docker network connect my_network mysql-db

如果my_network还未创建（比如还没启动过Compose），先手动创建网络：

docker network create my_network

之后启动SpringBoot容器时，它会自动加入my_network，就能通过容器名mysql-db访问现有MySQL容器了。

问题2：SpringBoot容器无法解析mysql-db的原因排查 #

常见原因有三类：

• 现有MySQL容器不在my_network网络中：这是最大概率的问题，按问题1的步骤把容器加入网络即可。
• MySQL绑定了127.0.0.1地址：如果启动MySQL容器时手动指定了--bind-address=127.0.0.1，或修改配置文件限制为本地访问，容器间将无法连接。检查MySQL容器启动参数，确保未绑定127.0.0.1（官方MySQL镜像默认bind-address=0.0.0.0，允许外部访问）。
• 数据库用户权限限制：你的operator用户可能仅允许从localhost连接，而容器间通信使用的是容器IP，并非localhost。进入MySQL容器执行以下命令检查并修改权限：

  # 检查用户允许的访问地址
  SELECT user, host FROM mysql.user WHERE user='operator';
  # 如果host是localhost，修改为允许任意地址访问
  GRANT ALL PRIVILEGES ON phonebook_db.* TO 'operator'@'%';
  FLUSH PRIVILEGES;
  

问题3：Docker默认网络能否替代自定义网络实现容器间通信 #

可以，但不推荐。Docker默认的bridge网络（未指定自定义网络时容器默认加入的网络）没有内置DNS解析功能，容器间只能通过IP地址通信，无法用容器名/服务名访问。你需要先查询MySQL容器的IP：

docker inspect mysql-db | grep "IPAddress"

再把SpringBoot配置中的mysql-db替换为该IP才能连接——这种方式灵活性差，容器重启后IP可能变化，后续添加Kafka、前端容器时维护成本极高。

而自定义bridge网络（即你配置的my_network）自带DNS解析，支持用容器名、服务名直接访问，是容器间通信的标准做法。后续添加Kafka、前端容器时，只要把它们都加入这个网络，就能直接用服务名通信（比如SpringBoot连接Kafka时用kafka:9092，假设Kafka服务名为kafka）。

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