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但需确保端口未被占用，且会降低并行测试兼容性。
总结：Testcontainers 的设计哲学是“面向抽象而非具体端口”，应始终依赖其提供的 getFirstMappedPort() 和 getJDBCUrl() 等方法获取运行时连接信息，而非硬编码或手动干预底层 Docker 网络配置。
