Failed to reset the input stream; If the request i...

不是库的 BUG。这个报错是 AWS Java SDK（S3）在重试请求时需要把输入流 reset，但做不到 时抛出的典型异常。SDK 在发送请求前会对输入流 mark()，若请求失败要重试就会尝试 reset()；如果你的流不支持 mark/reset，或者可回放的字节上限（readLimit）太小，超出了 SDK 默认的缓冲范围，就会报出这条提示。(AWS Documentation)

关键点（为什么会触发）

• 默认 readLimit 只有 128 KB（加 1 字节），超过这个范围后 reset 会失败，因此出现 “Failed to reset the input stream…”。（SDK 常量是 131073 = 128 KB + 1，并且文档中特别说明“+1”是为规避 BufferedInputStream 的实现细节。）(AWS Documentation)

---

解决办法（按推荐顺序）

1) 知道内容长度时：设置 Content-Length 并把 readLimit 调大到长度 + 1

java
ObjectMetadata meta = new ObjectMetadata();
meta.setContentLength(contentLength);          // 必须：告诉 S3 实际长度
PutObjectRequest req = new PutObjectRequest(bucket, key, inputStream, meta);

// readLimit 需 ≥ 需要回放的最大字节数；常见做法：长度 + 1（注意内存占用）
int limit = (contentLength >= Integer.MAX_VALUE) ? Integer.MAX_VALUE : (int)contentLength + 1;
req.getRequestClientOptions().setReadLimit(limit);

s3Client.putObject(req);

这是 AWS 官方在 v1“最佳实践”中的建议：若流支持 mark/reset，设置 setReadLimit(长度+1) 可以可靠避免 ResetException，但会以内存换可靠性。(AWS Documentation)

⚠️ 提醒：setReadLimit 会导致 SDK 在内存里缓冲最多 readLimit 字节。如果内容很大，不要盲目把 readLimit 设得过大，以免吃掉大量堆内存。(AWS Documentation)

2) 能不用 InputStream 时：直接传 File/FileInputStream

把数据源改成文件路径（new PutObjectRequest(bucket, key, file)）或 FileInputStream，SDK 在重试时可以重新打开并读取文件，不受 mark/reset 与 readLimit 的限制。这是官方推荐的最稳妥方式。(AWS Documentation)

3) 必须用 InputStream 且想全局生效：设置 JVM 系统属性

如果你很难逐个请求去设置 readLimit，可以用 JVM 启动参数全局调大 S3 的默认流缓冲上限，例如：

bash
-Dcom.amazonaws.sdk.s3.defaultStreamBufferSize=104857600   # 100MB

这个系统属性键即 com.amazonaws.sdk.s3.defaultStreamBufferSize（SDK 文档常量名 DEFAULT_S3_STREAM_BUFFER_SIZE，现已标注为更推荐用每请求的 setReadLimit）。同样要权衡内存占用。(AWS Documentation)

4) 若使用 AWS SDK for Java v2：按 v2 的流式上传最佳实践来

v2 不再提供 RequestClientOptions.setReadLimit，而是要求：

• 已知长度：用 RequestBody.fromInputStream(inputStream, contentLength)；
• 未知长度：用 RequestBody.fromContentProvider(...)（同步会先缓冲计算长度，可能内存大），或优先用 异步客户端（S3AsyncClient，AsyncRequestBody.fromInputStream，让 SDK 自动分片上传）。(AWS Documentation)

---

常见踩坑核对清单

• 你是否给 ObjectMetadata 设置了正确的 Content-Length？缺失或不准确会诱发各种流处理/签名问题。(AWS Documentation)
• 输入流是否支持 mark/reset？（很多网络流、解压流默认不支持；文件可用 File/FileInputStream 规避。）(AWS Documentation)
• 使用多段（multipart）上传时，重试需要回放的数据段大小同样要在 readLimit 的覆盖范围内；若用 File 更省心。(AWS Documentation)

---

关于“是不是 BUG？”

不是（绝大多数情况下）。这是 SDK 的既定设计：为了支持网络抖动下的重试，对输入流做 mark/reset。当流不可回放或回放窗口太小（默认仅 128 KB）就会失败并抛出你看到的异常信息。调整成上面的任一做法即可消除。(AWS Documentation)

另外：AWS Java SDK v1 已在 2024‑07‑31 进入维护模式，将于 2025‑12‑31 结束支持；若有条件，建议规划迁移到 v2。(AWS Documentation)

如果你方便贴一小段当前的上传代码（尤其是 PutObjectRequest/TransferManager 的构造方式和 ObjectMetadata 设置），我可以直接帮你改成更稳妥的版本。