嘿，我完全懂你迁移时找不到对应参数的头疼——AWS SDK V2把V1里集中在ClientConfiguration的参数拆分到了不同的配置节点里，不是直接堆在一个地方。我帮你把V1里的每个参数都对应到V2的配置方式，直接上代码和清晰的对应说明：

首先给你完整的V2代码示例，包含所有你需要的V1参数对应配置，之后再逐个拆解：

S3Client s3Client = S3Client.builder()
        .region(Region.of(s3Properties.getAwsRegion()))
        .credentialsProvider(StaticCredentialsProvider.create(basicSessionCredentials))
        .serviceConfiguration(S3Configuration.builder()
                .checksumValidationEnabled(true)
                .pathStyleAccessEnabled(false)
                .build())
        .overrideConfiguration(builder -> builder
                .apiCallTimeout(Duration.ofMinutes(15))
                .apiCallAttemptTimeout(Duration.ofSeconds(30))
                // 对应V1的setMaxErrorRetry(20) + setUseThrottleRetries(true)
                .retryPolicy(AdaptiveRetryPolicy.builder()
                        // 注意：V1的maxErrorRetry是重试次数，V2的maxAttempts是总尝试次数（含第一次调用）
                        .maxAttempts(21) // 20次重试对应21次总尝试
                        .build())
        )
        // 这里配置底层HTTP客户端的连接参数，对应V1里的大部分连接相关设置
        .httpClientBuilder(NettyNioAsyncHttpClient.builder()
                // 对应V1的setMaxConnections(100)
                .maxConcurrency(100)
                // 对应V1的setConnectionMaxIdleMillis(10000)
                .connectionMaxIdleTime(Duration.ofMillis(10000))
                // 对应V1的setUseTcpKeepAlive(true)
                .tcpKeepAlive(true)
                // 对应V1的setValidateAfterInactivityMillis(5000)
                .validateAfterInactivity(Duration.ofMillis(5000))
                // 对应V1的setSocketBufferSizeHints(2024, 3024)：第一个是接收缓冲区，第二个是发送缓冲区
                .socketReceiveBufferSizeInBytes(2024)
                .socketSendBufferSizeInBytes(3024)
                .build())
        .build();

每个V1参数的V2对应配置拆解 #

• setConnectionMaxIdleMillis(10000)：对应HTTP客户端配置里的connectionMaxIdleTime(Duration.ofMillis(10000))，设置连接空闲多久后被回收
• setUseTcpKeepAlive(true)：对应HTTP客户端的tcpKeepAlive(true)，开启TCP长连接保活机制
• setUseThrottleRetries(true)：V2里默认的AdaptiveRetryPolicy已经内置了节流重试逻辑，专门处理服务端限流类错误的重试，直接用这个策略就和V1的配置效果一致
• setMaxErrorRetry(20)：这里要注意，V1的参数是纯重试次数，而V2的maxAttempts是总调用尝试次数（包含第一次正常调用），所以要设置为21才能对应20次重试，这个配置放在overrideConfiguration的重试策略里
• setSocketBufferSizeHints(2024, 3024)：V2把这个拆成了两个独立配置：socketReceiveBufferSizeInBytes(2024)（对应V1的第一个参数）和socketSendBufferSizeInBytes(3024)（对应V1的第二个参数），都放在HTTP客户端配置中
• setValidateAfterInactivityMillis(5000)：对应HTTP客户端的validateAfterInactivity(Duration.ofMillis(5000))，设置连接空闲一段时间后，下次使用前先验证连接有效性
• setMaxConnections(100)：对应HTTP客户端的maxConcurrency(100)，设置客户端允许的最大并发连接数

额外注意点 #

• 如果你不显式指定HTTP客户端，SDK会用默认实现，但要配置这些连接参数，必须显式声明httpClientBuilder（上面用的Netty实现是SDK默认的异步HTTP客户端）
• V2的重试策略比V1更智能，AdaptiveRetryPolicy会根据服务端的限流信号动态调整重试频率，完全覆盖V1的节流重试功能
• V2所有时间参数都用Duration类指定，比V1的纯毫秒数更直观也更易维护