Spring Boot集成测试中TestContainer ElasticSearchContainer连接Docker异常

问题梳理 #

初始Docker环境检测失败 #

使用Testcontainers启动Elasticsearch容器时，出现无法找到有效Docker环境错误，日志提示NpipeSocketClientProviderStrategy未通过测试、找不到docker-machine可执行文件。
初始代码：

@ClassRule
public static ElasticsearchContainer elasticsearch =
            new ElasticsearchContainer(DockerImageName.parse("docker.elastic.co/elasticsearch/elasticsearch:8.10.4"));

后续Hibernate Search连接失败 #

添加端口绑定并指定DOCKER_HOST后，Docker环境问题解决，但Hibernate Search无法连接Elasticsearch，报错：

org.hibernate.search.util.common.SearchException: HSEARCH400080: Unable to detect the Elasticsearch version running on the cluster: HSEARCH400007: Elasticsearch request failed: Connection is closed
Request: GET  with parameters {}
Response: (no response)

分步解决 #

1. 修复Docker环境检测问题 #

Windows下Testcontainers默认优先使用npipe协议，你已经开启了Docker daemon的TCP无TLS暴露，需要强制Testcontainers使用TCP连接：

• 在测试类的静态代码块中设置系统属性：

static {
    System.setProperty("docker.host", "tcp://localhost:2375");
    System.setProperty("docker.tls.verify", "0"); // 禁用TLS验证
}

或者在IDE运行配置中添加环境变量：
DOCKER_HOST=tcp://localhost:2375、DOCKER_TLS_VERIFY=0

2. 解决Hibernate Search与容器的连接问题 #

Elasticsearch 8.x默认开启HTTPS和身份验证，Testcontainers的ElasticsearchContainer可自动处理，但需注意以下几点：

• 不要手动绑定固定端口：Testcontainers会自动映射随机端口，硬写localhost:9200会导致地址不匹配
• 动态注入容器地址：通过容器的getHttpHostAddress()方法获取实际连接地址，配置给Hibernate Search：

@ClassRule
public static ElasticsearchContainer elasticsearch = new ElasticsearchContainer(
        DockerImageName.parse("docker.elastic.co/elasticsearch/elasticsearch:8.10.4")
)
.withEnv("xpack.security.enabled", "false"); // 测试环境可禁用安全特性简化配置

@DynamicPropertySource
static void configureElasticsearch(DynamicPropertyRegistry registry) {
    registry.add("hibernate.search.backend.elasticsearch.hosts", elasticsearch::getHttpHostAddress);
    registry.add("hibernate.search.backend.elasticsearch.ssl.enabled", () -> "false");
}

3. 优化容器启动等待逻辑 #

Elasticsearch启动需要一定时间，添加等待策略确保容器完全就绪后再执行测试：

@ClassRule
public static ElasticsearchContainer elasticsearch = new ElasticsearchContainer(
        DockerImageName.parse("docker.elastic.co/elasticsearch/elasticsearch:8.10.4")
)
.withEnv("xpack.security.enabled", "false")
.waitingFor(Wait.forHttp("/").forStatusCode(200).withStartupTimeout(Duration.ofMinutes(2)));

4. 版本兼容性调整 #

Spring Boot 2.5.5官方适配的Testcontainers版本为1.17.x，你当前使用的1.19.1可能存在小兼容性问题，建议将Testcontainers版本调整为1.17.6，避免潜在冲突。

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