Testcontainers启动Minio容器上传文件出现签名匹配异常

签名不匹配的核心诱因是MinIO Java SDK默认启用虚拟主机风格寻址，两类请求的寻址逻辑差异导致了反常的现象：

• 创建存储桶、列举存储桶类操作默认走路径风格寻址，请求结构为http://<服务地址>:<端口>/<bucket名>，SDK计算签名时使用的Host头与实际请求发送的Host头完全一致，因此可以正常执行
• 文件上传、下载等对象操作默认会将存储桶名拼接为Host前缀，请求结构为http://<bucket名>.<服务地址>:<端口>/<对象名>。Testcontainers启动的容器通过随机映射端口暴露在本地回环地址上，本地不存在<bucket名>.127.0.0.1的域名解析记录，实际请求发出时Host头仍为127.0.0.1:<随机端口>，和SDK计算签名时使用的Host值不一致，直接触发签名校验失败。

1. 调整MinIO客户端构造逻辑 #

显式关闭虚拟主机寻址模式，强制所有请求使用路径风格访问，替换原有的MinioClient构造代码：

private final MinioClient minioClient = MinioClient.builder()
        .endpoint(
                new URL(String.format("http://%s:%d",
                        minioContainer.getHost(),
                        minioContainer.getMappedPort(defaultPort)
                )),
                false // 核心配置：禁用虚拟主机风格，强制路径寻址
        )
        .credentials(accessKey, secretKey)
        .build();

注意将已过时的getContainerIpAddress()替换为Testcontainers官方推荐的getHost()方法，避免不同环境下容器IP获取异常。

2. 适配高版本MinIO镜像的环境变量配置 #

如果你使用的是RELEASE.2022-01-08之后的MinIO镜像，旧版的MINIO_ACCESS_KEY、MINIO_SECRET_KEY环境变量已被弃用，替换为官方新的初始密钥配置即可避免认证逻辑兼容问题：

@Container
private static final GenericContainer<?> minioContainer =
        new GenericContainer<>(DockerImageName.parse("quay.io/minio/minio"))
                .withExposedPorts(defaultPort)
                .withEnv("MINIO_ROOT_USER", accessKey)
                .withEnv("MINIO_ROOT_PASSWORD", secretKey)
                .withCommand("server", "/data");

调整完成后重启测试，文件上传接口即可正常执行，不会再出现签名不匹配的错误。

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