apache/hadoop · error · IllegalArgumentException

Query string param is not encode-able: {}={}

Error message

Query string param is not encode-able: {}={}

What it means

Error "Query string param is not encode-able: {}={}" thrown in apache/hadoop.

Source

Thrown at hadoop-tools/hadoop-azure/src/main/java/org/apache/hadoop/fs/azurebfs/services/AbfsUriQueryBuilder.java:64

  }

  @Override
  public String toString() {
    StringBuilder sb = new StringBuilder();
    boolean first = true;

    for (Map.Entry<String, String> entry : parameters.entrySet()) {
      if (first) {
        sb.append(AbfsHttpConstants.QUESTION_MARK);
        first = false;
      } else {
        sb.append(AbfsHttpConstants.AND_MARK);
      }
      try {
        sb.append(entry.getKey()).append(AbfsHttpConstants.EQUAL).append(AbfsClient.urlEncode(entry.getValue()));
      }
      catch (AzureBlobFileSystemException ex) {
        throw new IllegalArgumentException("Query string param is not encode-able: " + entry.getKey() + "=" + entry.getValue());
      }
    }
    // append SAS Token
    if (sasToken != null) {
      if (first) {
        sb.append(AbfsHttpConstants.QUESTION_MARK);
      } else {
        sb.append(AbfsHttpConstants.AND_MARK);
      }

      sb.append(sasToken);
    }
    return sb.toString();
  }
}

View on GitHub (pinned to 2add963021)

Solutions

1. Remove or replace characters in the query parameter that cannot be URL-encoded.
2. Use valid UTF-8-encodable names/values for query parameters.

When it happens

Trigger: A query string parameter contains characters that fail URL encoding when building the ABFS request URI.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/hadoop@2add963021 (2026-08-22). Data as JSON: /api/errors/95193fc5cb889742. Report an issue: GitHub.