Spring多线程环境下使用AmazonS3客户端上传文件的线程安全问题咨询

你当前将AmazonS3实例作为Spring单例Bean的使用方式是完全安全的，不需要将客户端创建逻辑移到uploadFile方法内。

需要明确的是：标注@NotThreadSafe的是AmazonS3ClientBuilder构建器类，仅代表构建过程不能多线程并发执行；而build()方法生成的AmazonS3客户端实例本身是线程安全的，完全支持多线程场景下并发调用。Spring默认单例Bean的创建逻辑只会执行一次构建器的构建流程，不存在构建过程的并发问题，完全符合使用规范。

你遇到的Timeout waiting for connection from pool报错本质是默认连接池容量不足，并发请求时无空闲连接可用。你当前调大maxConnections的思路是正确的，可进一步优化配置提升稳定性：

@Bean
public AmazonS3 s3Client() {
    ClientConfiguration clientConfig = new ClientConfiguration()
            // 可根据实际并发压测结果调整，高并发场景可上调至200~300
            .withMaxConnections(100)
            // 连接建立超时，100ms过短易因网络波动误超时，建议调整为500ms以上
            .withConnectionTimeout(500)
            // 数据传输超时，大文件上传场景可适当调大
            .withSocketTimeout(30000)
            .withMaxErrorRetry(5)
            // 空闲超过5s的连接使用前先校验有效性，避免拿到服务端已断开的无效连接
            .withValidateAfterInactivity(5000);
    return AmazonS3ClientBuilder
            .standard()
            .withClientConfiguration(clientConfig)
            .build();
}

• 全应用复用同一个AmazonS3单例实例即可，禁止每次上传请求都新建客户端：新建客户端开销极高，且每个客户端会维护独立的连接池，会导致大量TCP连接无法复用，反而加重连接超时问题。
• 上传逻辑中所有IO资源（比如S3ObjectInputStream、文件输入流等）必须使用try-with-resources主动关闭，避免连接泄漏导致连接被长时间占用无法回收到池。
• 大文件上传优先使用分片上传接口，缩短单个请求占用连接的时长，提升连接池利用率。
• 可埋点监控连接池等待超时次数、空闲连接数等指标，根据实际流量动态调整maxConnections数值。

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