我们宣布了即将推出 end-of-support 的 AWS SDK for Java (v1)。建议您迁移到 AWS SDK for Java v2。有关日期、其他详细信息以及如何迁移的信息，请参阅链接的公告。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AWS 开发的最佳实践 AWS SDK for Java

以下最佳做法可以帮助您在使用开发 AWS 应用程序时避免出现问题或麻烦 AWS SDK for Java。这些最佳实践已按服务分类整理。

S3

避免 ResetExceptions

当您使用流（通过AmazonS3客户端或TransferManager）将对象上传到 Amazon S3 时，可能会遇到网络连接或超时问题。默认情况下， AWS SDK for Java 尝试重试传输失败的方法是在传输开始之前标记输入流，然后在重试之前对其进行重置。

如果直播不支持标记和重置，则当出现暂时性故障并启用重试ResetException时，SDK 会抛出。

最佳实践

建议您使用支持标记和重置操作的流。

避免 a 的最可靠方法ResetException是使用文件或来提供数据 FileInputStream，它们 AWS SDK for Java 可以在不受标记和重置限制的限制的情况下处理这些数据。

如果直播不是，FileInputStream但支持标记和重置，则可以使用setReadLimit方法设置标记限制RequestClientOptions。其默认值为 128KB。将读取限制值设置为比流大小大一个字节将可靠地避免 ResetException.

例如，如果流的最大预期大小为 100000 字节，则将读取限制设置为 100001 (100000 + 1) 字节。标记和重置操作将始终适用于 100000 字节或更少的字节。请注意，这可能会导致一些流将该数量的字节缓冲到内存中。