使用Java SDK在LocalStack中通过Lambda访问S3遇连接拒绝问题

问题原因 #

Lambda运行在独立的Docker容器中，当使用虚拟主机样式访问S3（即bucketName.localhost.localstack.cloud）时，localhost会被解析为Lambda容器自身的回环地址，而非LocalStack主容器的IP，导致连接被拒绝。

解决方案 #

1. 启用S3路径样式访问（关键修复） #

修改Java代码中的S3客户端配置，添加withPathStyleAccessEnabled(true)，强制使用路径样式访问（请求格式为endpoint/bucket/key），避免虚拟主机样式的解析问题：

AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
        .withCredentials(new AWSStaticCredentialsProvider(credentials()))
        .withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("s3.localhost.localstack.cloud:4566",
                Regions.US_EAST_1.getName()))
        .withPathStyleAccessEnabled(true) // 启用路径样式访问
        .build();

S3Object s3Object = s3Client.getObject("bucketName", "Key.sql");

2. 优化容器网络访问（可选，更可靠） #

如果使用Docker Compose或自定义网络部署LocalStack，建议将Lambda容器加入LocalStack所在的网络，并直接使用LocalStack容器名称作为端点主机名，避免localhost的解析歧义：

AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
        .withCredentials(new AWSStaticCredentialsProvider(credentials()))
        .withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("localstack:4566", Regions.US_EAST_1.getName()))
        .withPathStyleAccessEnabled(true)
        .build();

注：localstack是LocalStack容器的默认名称，若你自定义了容器名，请替换为实际名称。

3. 验证配置有效性 #

重新部署Lambda函数后，再次执行invoke命令：

awslocal lambda invoke --function-name optimization-data-loader /dev/stdout

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