Amazon S3上传遇ResetException：改用FileInputStream是否有效？

问题描述 #

我在向AWS S3上传文件时频繁失败，报错信息如下：

Caused by: com.amazonaws.ResetException: The request to the service failed with a retryable reason, but resetting the request input stream has failed. See exception.getExtraInfo or debug-level logging for the original failure that caused this retry.; If the request involves an input stream, the maximum stream buffer size can be configured via request.getRequestClientOptions().setReadLimit(int)

查阅AWS官方文档得知，避免ResetException的最佳实践是使用File或FileInputStream提供数据。目前我的代码使用的是InputStream（FileInputStream的父类），想了解将类型改为FileInputStream是否能解决问题？此外我也可以选择设置setReadLimit，但不确定前者的改动是否足够，望解答。

回答 #

• 改用FileInputStream可以彻底解决问题
  FileInputStream原生支持mark()和reset()操作（markSupported()返回true），它直接关联本地文件，当AWS SDK遇到可重试的错误（比如网络波动）需要重新发送请求时，能轻松将流重置到起始位置，不会出现重置失败的情况。这也是AWS官方推荐该方案的核心原因——这类基于文件的流天生适配SDK的重试机制。

• 为什么用InputStream会触发异常
  InputStream作为抽象父类，很多实现类（比如自定义流、网络流）并不支持mark/reset能力，或者重置存在限制。当SDK尝试重置流进行重试时，就会抛出ResetException。

• setReadLimit方案的局限性
  设置setReadLimit(int)的原理是让SDK在首次读取流时，将数据缓存到内存中，重试时直接复用缓存内容。但这种方式只适合小文件：如果上传的文件过大，缓存会占用大量内存，甚至引发内存溢出（OOM）。而FileInputStream无需额外缓存，直接从本地文件重新读取，没有内存占用的隐患。

• 结论
  优先选择改用FileInputStream，这是最稳妥、符合官方最佳实践的方案，能从根源上解决ResetException问题。如果因业务限制无法使用FileInputStream，再考虑使用setReadLimit，但要根据文件大小合理设置缓存上限，避免内存问题。

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