如何正确配置 MariaDB Testcontainer 以支持本地主机连接-java教程-PHP中文网

如何正确配置 MariaDB Testcontainer 以支持本地主机连接

Testcontainers 中的 MariaDB 容器默认将 3306 端口映射到宿主机的随机可用端口，而非固定绑定到 localhost:3306；需通过 getFirstMappedPort() 获取实际映射端口，并避免手动调用 setPortBindings 导致配置冲突。

testcontainers 中的 mariadb 容器默认将 3306 端口映射到宿主机的随机可用端口，而非固定绑定到 localhost:3306；需通过 `getfirstmappedport()` 获取实际映射端口，并避免手动调用 `setportbindings` 导致配置冲突。

在使用 Testcontainers 进行集成测试时，MariaDB 容器（如 MariaDBContainer）默认采用 Docker 的端口映射机制：容器内 3306 端口会被动态映射到宿主机上一个未被占用的随机端口（例如 32789），而非直接暴露为 localhost:3306。这就是为何执行 mariadb --host localhost --port 3306 ... 失败并报错 ERROR 2002 (HY000): Can't connect to server on 'localhost' (99) 的根本原因——宿主机的 3306 端口并未被容器监听，真正可连的是类似 localhost:32789 的映射端口。

✅ 正确做法如下：

无需手动调用 withExposedPorts(3306) 或 setPortBindings(...)：MariaDBContainer 已内置自动端口暴露与映射逻辑，显式设置反而可能干扰内部状态（尤其是 setPortBindings 在容器启动后调用属于误用，可能导致端口绑定失效或重复绑定异常）。

获取真实可访问端口应使用标准 API：

int mappedPort = mariadb.getFirstMappedPort(); // 推荐：获取首个映射端口（即 3306 对应的宿主机端口）
String jdbcUrl = mariadb.getJDBCUrl();         // 自动拼接含正确 host 和 port 的 JDBC URL，如 "jdbc:mariadb://localhost:32789/db"

验证连接方式（宿主机视角）：

# ✅ 正确：使用映射端口（由 getFirstMappedPort() 返回）
mariadb --host localhost --port 32789 --user user --password

# ❌ 错误：硬编码 3306（除非显式指定 host.docker.internal 或使用 host network 模式，但不推荐）
mariadb --host localhost --port 3306 --user user --password

⚠️ 注意事项：

若需在同一 Docker 网络内的其他容器中访问 MariaDB，请使用 --host mariadb（即 withNetworkAliases("mariadb") 所设别名）+ 默认端口 3306，此时走的是 Docker 内部网络，无需端口映射；
宿主机（开发机/CI 机器）访问必须通过 getFirstMappedPort() 获取动态端口，不可假设为 3306；
移除 mariadb.setPortBindings(...) 调用——该方法用于低级 Docker 绑定配置，与 Testcontainers 高层抽象冲突，且在 start() 后调用无效；
如需固定宿主机端口（仅限开发调试，不推荐用于 CI），可改用：
```
new MariaDBContainer("mariadb:10.5.8")
    .withFixedExposedPort(3307, 3306) // 将容器 3306 映射到宿主机 3307
```
但需确保端口未被占用，且会降低并行测试兼容性。