binarywang/WxJava · error · WxErrorException

-99

-99

Error message

无法获取到文件名，Content-disposition为空

What it means

Error "无法获取到文件名，Content-disposition为空" thrown in binarywang/WxJava.

Source

Thrown at weixin-java-common/src/main/java/me/chanjar/weixin/common/util/http/hc/HttpComponentsResponseProxy.java:20

import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.common.util.http.HttpResponseProxy;
import org.apache.hc.client5.http.impl.classic.CloseableHttpResponse;
import org.apache.hc.core5.http.Header;

public class HttpComponentsResponseProxy implements HttpResponseProxy {

  private final CloseableHttpResponse response;

  public HttpComponentsResponseProxy(CloseableHttpResponse closeableHttpResponse) {
    this.response = closeableHttpResponse;
  }

  @Override
  public String getFileName() throws WxErrorException {
    Header[] contentDispositionHeader = this.response.getHeaders("Content-disposition");
    if (contentDispositionHeader == null || contentDispositionHeader.length == 0) {
      throw new WxErrorException("无法获取到文件名，Content-disposition为空");
    }

    return HttpResponseProxy.extractFileNameFromContentString(contentDispositionHeader[0].getValue());
  }
}

View on GitHub (pinned to 1c43293a3c)

Solutions

1. 确认微信接口响应确实包含 Content-disposition 头；若接口不返回文件名，改用自行指定文件名保存。
2. 检查是否因响应为 JSON 错误报文导致缺少该头，先按 errorCode 处理接口错误。

When it happens

Trigger: Thrown at weixin-java-common/src/main/java/me/chanjar/weixin/common/util/http/hc/HttpComponentsResponseProxy.java:20 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of binarywang/WxJava@1c43293a3c (2026-08-14). Data as JSON: /api/errors/9ebed76419b7785f. Report an issue: GitHub.