如何测试Testcontainers调用的Podman Socket HTTP并排查通信挂起问题

根据日志里的请求细节，Testcontainers发起的是通过Unix套接字访问Podman API的GET请求，路径为/v1.32/info，附带特定请求头。以下是几种直接复现该请求的方法：

方法1：用curl直接发起请求 #

curl支持通过Unix套接字发送HTTP请求，命令如下：

# 先获取Podman实际的套接字路径
PODMAN_SOCK=$(podman info --format '{{.Host.RemoteSocket.Path}}')

# 发起与Testcontainers完全一致的请求
curl --unix-socket $PODMAN_SOCK \
  -H "x-tc-sid: 17aa0133-17d2-48fb-8d9c-0a6466724e15" \
  -H "User-Agent: tc-java/1.19.1" \
  -H "Accept-Encoding: gzip, x-gzip, deflate" \
  -H "Host: localhost:2375" \
  -H "Connection: keep-alive" \
  http://localhost/v1.32/info

方法2：用netcat手动构造请求 #

如果需要更底层的调试，可以用nc直接连接套接字并输入HTTP报文：

1. 连接Podman套接字：

nc -U $(podman info --format '{{.Host.RemoteSocket.Path}}')

2. 在nc会话中粘贴以下请求内容（注意末尾必须加两个换行）：

GET /v1.32/info HTTP/1.1
x-tc-sid: 17aa0133-17d2-48fb-8d9c-0a6466724e15
User-Agent: tc-java/1.19.1
Accept-Encoding: gzip, x-gzip, deflate
Host: localhost:2375
Connection: keep-alive

方法3：用Java代码模拟Testcontainers的请求 #

由于Testcontainers使用Apache HttpClient发起请求，可编写一段Java代码完全复现该逻辑：

import org.apache.http.HttpHost;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.conn.socket.PlainConnectionSocketFactory;
import java.io.IOException;
import java.net.Socket;
import java.net.URI;

public class PodmanSocketRequest {
    public static void main(String[] args) throws IOException {
        // 替换为实际的Podman套接字路径，也可通过podman info命令动态获取
        String socketPath = "/run/user/1000/podman/podman.sock";

        // 自定义套接字工厂，连接Unix套接字
        PlainConnectionSocketFactory socketFactory = new PlainConnectionSocketFactory() {
            @Override
            public Socket createSocket(HttpHost host) throws IOException {
                return new Socket(new URI("unix://" + socketPath));
            }
        };

        CloseableHttpClient client = HttpClients.custom()
                .setSocketFactory(socketFactory)
                .build();

        // 构造与Testcontainers一致的请求
        HttpGet request = new HttpGet("/v1.32/info");
        request.addHeader("x-tc-sid", "17aa0133-17d2-48fb-8d9c-0a6466724e15");
        request.addHeader("User-Agent", "tc-java/1.19.1");
        request.addHeader("Accept-Encoding", "gzip, x-gzip, deflate");
        request.addHeader("Host", "localhost:2375");
        request.addHeader("Connection", "keep-alive");

        try (CloseableHttpResponse response = client.execute(new HttpHost("localhost"), request)) {
            System.out.println("响应状态码：" + response.getStatusLine());
            // 可添加代码读取响应体内容
        } finally {
            client.close();
        }
    }
}

需要添加Apache HttpClient依赖：

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.14</version>
</dependency>

额外排查建议 #

• 检查套接字权限：确认Testcontainers运行用户（如gitlab-runner）对Podman套接字有读写权限，可通过ls -l $PODMAN_SOCK查看所属用户组，必要时将用户加入对应组。
• 确认Podman服务状态：rootless模式下Podman服务默认不会常驻，可执行podman system service --time=0 unix://$PODMAN_SOCK启动常驻服务后再测试。
• 基础连通性测试：先执行curl --unix-socket $PODMAN_SOCK http://localhost/v1.32/info（不带自定义头），确认Podman API本身可正常响应。

内容的提问来源于stack exchange，提问作者Gaël J