MariaDB Testcontainer无法通过localhost连接问题咨询

核心原因：容器的localhost指向自身而非MariaDB容器 #

在Docker自定义网络中，每个容器拥有独立的网络命名空间，容器内的localhost（127.0.0.1）仅指向容器自身，并非同一网络中的其他容器。

你在其他容器执行mariadb --host localhost --port 3306时，实际是尝试连接当前容器的3306端口，但该容器并未运行MariaDB服务，因此会抛出ERROR 2002 (HY000): Can't connect to server on 'localhost' (99)（错误码99对应EADDRNOTAVAIL，表示指定地址/端口无监听进程）。

而用<MARIADBCONTAINER_NAME>或网络别名mariadb能成功连接，是因为Docker自定义网络会自动维护DNS解析，将容器名称/别名映射到对应容器IP，从而正确路由到MariaDB容器的3306端口。

代码中的额外问题：端口绑定时机错误 #

你的Testcontainer代码中，mariadb.setPortBindings在mariadb.start()之后调用，这会导致端口绑定配置不生效：

mariadb.start();
mariadb.setPortBindings(Collections.singletonList(mariadb.getMappedPort(3306) +":3306"));

Testcontainer要求端口绑定必须在容器启动前配置，正确做法是在容器构建链中使用withPortBindings：

MariaDBContainer mariadb = new MariaDBContainer<>(DockerImageName.parse("mariadb").withTag("10.5.8"))
        // ...其他配置项
        .withExposedPorts(3306)
        .withPortBindings(new PortBinding(Ports.Binding.bindPort(3306), Ports.containerPort(3306)))
        ;
mariadb.start();

注意：这个配置是为了让宿主机能通过localhost:3306连接MariaDB，而非让同一网络内的其他容器用localhost通信——容器间通信仍需使用目标容器的名称/别名。

总结 #

• 同一Docker网络内的容器通信，必须使用目标容器的名称、网络别名或IP，不能用localhost；
• 若要从宿主机连接MariaDB，需在容器启动前正确配置端口绑定，确保宿主机端口与容器3306端口映射生效；
• 代码中setPortBindings的调用时机错误，应调整为启动前用withPortBindings配置。

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