TestContainers.Keycloak 自定义镜像的健康检查配置问题解析

在使用TestContainers.Keycloak模块时，当开发者基于Keycloak 25版本构建自定义Docker镜像时，可能会遇到健康检查端点(healthcheck)无法正常工作的情况。这个问题源于Keycloak 25版本对健康检查机制的变更。

TestContainers.Keycloak模块从3.10.0版本开始，已经针对Keycloak 25+版本的健康检查端点进行了适配。模块内部会根据镜像版本号自动选择正确的健康检查路径。然而，当开发者使用自定义版本号的镜像时，这种自动适配机制可能会失效。

问题的核心在于：

1. 官方Keycloak镜像遵循语义化版本控制
2. 模块内部通过解析镜像版本来确定使用哪个健康检查端点
3. 自定义镜像可能不遵循相同的版本规范

解决方案有两种途径：

1. 覆盖默认等待策略： 开发者可以手动指定适合自己镜像的健康检查端点，覆盖模块提供的默认配置。这种方式适合对TestContainers比较熟悉的开发者。

2. 使用通用构建器： 对于需要完全自定义配置的情况，可以使用TestContainers的通用容器构建器从头开始创建容器配置。这种方式提供了最大的灵活性，但需要更多配置工作。

对于大多数情况，推荐采用第一种方案，因为它既保持了模块的便利性，又提供了必要的自定义能力。实现时只需要在容器初始化代码中覆盖WaitStrategy即可。

这个问题反映了在使用容器化测试工具时的一个常见场景：当基础镜像发生变化或使用自定义镜像时，测试工具可能需要相应调整。理解这种机制有助于开发者更好地处理类似情况。

值得注意的是，TestContainers模块在设计上是"有主见的"(opinionated)，这意味着它们为常见用例提供了合理的默认配置，但并不试图覆盖所有可能的自定义场景。开发者需要根据实际情况选择合适的扩展方式。