HTTP Post请求重试时参数为空问题排查

• 请求体流被读取耗尽
  多数HTTP客户端的请求体基于流结构（比如Java的InputStream、Python的io.BytesIO），第一次发送请求时会将流的内容全部读取并发送，此时流的指针会移动到末尾。重试时如果直接复用这个流，就会因为没有剩余数据导致请求体为空。
  错误示例（Java）：

  InputStream bodyStream = new ByteArrayInputStream("{\"key\":\"value\"}".getBytes());
  HttpPost post = new HttpPost(url);
  post.setEntity(new InputStreamEntity(bodyStream));
  // 第一次发送
  client.execute(post);
  // 重试时流已耗尽，请求体为空
  client.execute(post);
  

  解决方式：每次重试都重新创建请求体流，比如通过Supplier提供新的流实例。

• 参数对象被意外修改/清空
  如果重试逻辑复用了同一个参数对象，第一次请求后可能有业务代码或序列化逻辑将对象内的字段清空、置空。比如某个DTO对象在序列化后被调用了clear()方法，或者字段被其他线程修改，导致重试时对象无有效数据。

• 序列化逻辑未支持重复执行
  若参数体需要经过序列化（比如转JSON、XML），部分自定义序列化工具或框架可能会在第一次序列化后修改对象状态（比如标记为已序列化），导致二次序列化时无法生成有效内容。比如某些ORM框架的对象在序列化后会清空临时字段，重试时无法再次序列化出数据。

• 重试框架未正确处理请求体复用
  使用第三方重试框架（如Spring Retry、Guava Retry）时，如果框架仅重复执行发送方法，未重新构建请求体，就会复用已被消耗的请求资源。比如框架缓存了第一次的请求实例，重试时直接复用，而该实例的请求体已经被耗尽。

• HTTP客户端的状态性限制
  部分HTTP客户端实例是有状态的，第一次请求后客户端内部的缓存、连接状态会影响重试请求。比如某些客户端会缓存请求体内容，第一次发送后缓存被释放，重试时无法重新获取请求体数据。

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