apache/hadoop · error · IllegalStateException

ReadBufferManagerV2 is not configured. Please call setReadBu

Error message

ReadBufferManagerV2 is not configured. Please call setReadBufferManagerConfigs() before calling getBufferManager().

What it means

Error "ReadBufferManagerV2 is not configured. Please call setReadBufferManagerConfigs() before calling getBufferManager()." thrown in apache/hadoop.

Source

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

   *
   * @param abfsCounters the {@link AbfsCounters} used for managing read operations.
   */
  private ReadBufferManagerV2(AbfsCounters abfsCounters) {
    this.abfsCounters = abfsCounters;
    readThreadPoolMetrics = abfsCounters.getAbfsReadResourceUtilizationMetrics();
    vectoredReadHandler = new VectoredReadHandler(this);
    printTraceLog("Creating Read Buffer Manager V2 with HADOOP-18546 patch");
  }

  /**
   * Returns the singleton instance of {@code ReadBufferManagerV2}.
   *
   * @param abfsCounters the {@link AbfsCounters} used for read operations.
   * @return the singleton instance of {@code ReadBufferManagerV2}.
   */
  static ReadBufferManagerV2 getBufferManager(AbfsCounters abfsCounters) {
    if (!isConfigured.get()) {
      throw new IllegalStateException("ReadBufferManagerV2 is not configured. "
          + "Please call setReadBufferManagerConfigs() before calling getBufferManager().");
    }
    if (bufferManager == null) {
      LOCK.lock();
      try {
        if (bufferManager == null) {
          bufferManager = new ReadBufferManagerV2(abfsCounters);
          bufferManager.init();
          LOGGER.trace("ReadBufferManagerV2 singleton initialized");
        }
      } finally {
        LOCK.unlock();
      }
    }
    return bufferManager;
  }

  VectoredReadHandler getVectoredReadHandler() {

View on GitHub (pinned to 2add963021)

Solutions

1. Call setReadBufferManagerConfigs() before getBufferManager() when using ReadBufferManagerV2 directly.
2. Through the ABFS driver, ensure filesystem initialization completes before reads.

When it happens

Trigger: getBufferManager() is invoked on ReadBufferManagerV2 before its configuration is set.

Common situations: See trigger scenarios.

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