apache/hadoop · error · IOException

Failed to initialize %s queues for the provided keys.

Error message

Failed to initialize %s queues for the provided keys.

What it means

Error "Failed to initialize %s queues for the provided keys." thrown in apache/hadoop.

Source

Thrown at hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/crypto/key/kms/ValueQueue.java:288

   * fill Method with "numInitValues" values
   * @param keyNames Array of key Names
   * @throws IOException if initialization fails for any provided keys
   */
  public void initializeQueuesForKeys(String... keyNames) throws IOException {
    int successfulInitializations = 0;
    ExecutionException lastException = null;

    for (String keyName : keyNames) {
      try {
        keyQueues.get(keyName);
        successfulInitializations++;
      } catch (ExecutionException e) {
        lastException = e;
      }
    }

    if (keyNames.length > 0 && successfulInitializations != keyNames.length) {
      throw new IOException(String.format("Failed to initialize %s queues for the provided keys.",
          keyNames.length - successfulInitializations), lastException);
    }
  }

  /**
   * This removes the value currently at the head of the Queue for the
   * provided key. Will immediately fire the Queue filler function if key
   * does not exist.
   * If Queue exists but all values are drained, It will ask the generator
   * function to add 1 value to Queue and then drain it.
   * @param keyName String key name
   * @return E the next value in the Queue
   * @throws IOException raised on errors performing I/O.
   * @throws ExecutionException executionException.
   */
  public E getNext(String keyName)
      throws IOException, ExecutionException {
    return getAtMost(keyName, 1).get(0);

View on GitHub (pinned to 2add963021)

Solutions

1. The ValueQueue failed to initialize its per-key queues; check the wrapped cause and the queue/timeout configuration.

Example fix

Verify kms client configuration and key names.

When it happens

Trigger: Raised at runtime when the documented precondition or configuration requirement for this operation is violated.

Common situations: Misconfigured or missing property, invalid user input, or calling the API before its prerequisites are met.

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