Docker环境下访问LocalStack S3出现502错误求助

核心原因 #

本地代码用localhost:4566能正常访问LocalStack，是因为此时localhost指向宿主机；但Docker容器内的localhost是容器自身，无法直接访问宿主机或同网络下的LocalStack容器，导致请求失败返回502错误。

具体解决方法 #

1. 统一Docker网络（推荐） #

如果你的应用和LocalStack都以Docker容器运行，将它们加入同一个Docker网络：

• 使用Docker Compose时，默认会创建专属网络，直接在代码中用LocalStack的服务名作为地址：

  .endpointOverride(URI.create("http://localstack:4566"))
  

• 手动创建并加入网络：

  docker network create localstack-network
  docker run --network localstack-network --name localstack -p 4566:4566 localstack/localstack
  docker run --network localstack-network your-app-image
  

  代码中同样使用http://localstack:4566作为endpoint。

2. 用宿主机IP访问 #

如果LocalStack运行在宿主机而非容器中：

• Windows/macOS：使用Docker内置的host.docker.internal映射宿主机：

  .endpointOverride(URI.create("http://host.docker.internal:4566"))
  

• Linux：使用宿主机的Docker网关IP（通常为172.17.0.1）或实际局域网IP：

  .endpointOverride(URI.create("http://172.17.0.1:4566"))
  

3. 确认LocalStack端口映射 #

确保启动LocalStack时正确映射4566端口，否则外部（包括容器）无法访问：

docker run -p 4566:4566 localstack/localstack

4. 验证网络连通性 #

在应用容器内执行curl命令，确认LocalStack地址可正常访问：

curl http://localstack:4566/test/file.txt

修改后的代码示例 #

public static void main(String[] args) {
    AwsBasicCredentials credentials = AwsBasicCredentials.create("test", "test");
    StaticCredentialsProvider staticCredentialsProvider =
        StaticCredentialsProvider.create(credentials);

    S3Client s3Client =
        S3Client.builder()
            .region(Region.of("us-east-1"))
            .endpointOverride(URI.create("http://localstack:4566")) // 替换为正确的访问地址
            .credentialsProvider(staticCredentialsProvider)
            .forcePathStyle(true)
            .build();
    GetObjectRequest getObjectRequest =
        GetObjectRequest.builder().bucket("test").key("file.txt").build();
    ResponseBytes<GetObjectResponse> response = s3Client.getObjectAsBytes(getObjectRequest);
    System.out.println(response);
}

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