{"record":{"id":"42c915f98297878d","repo":"apache/hadoop","slug":"readbuffermanagerv2-is-not-configured-please-call","errorCode":null,"errorMessage":"ReadBufferManagerV2 is not configured. Please call setReadBufferManagerConfigs() before calling getBufferManager().","messagePattern":"ReadBufferManagerV2 is not configured\\. Please call setReadBufferManagerConfigs\\(\\) before calling getBufferManager\\(\\)\\.","errorType":"exception","errorClass":"IllegalStateException","httpStatus":null,"severity":"error","filePath":"hadoop-tools/hadoop-azure/src/main/java/org/apache/hadoop/fs/azurebfs/services/ReadBufferManagerV2.java","lineNumber":155,"sourceCode":"   *\n   * @param abfsCounters the {@link AbfsCounters} used for managing read operations.\n   */\n  private ReadBufferManagerV2(AbfsCounters abfsCounters) {\n    this.abfsCounters = abfsCounters;\n    readThreadPoolMetrics = abfsCounters.getAbfsReadResourceUtilizationMetrics();\n    vectoredReadHandler = new VectoredReadHandler(this);\n    printTraceLog(\"Creating Read Buffer Manager V2 with HADOOP-18546 patch\");\n  }\n\n  /**\n   * Returns the singleton instance of {@code ReadBufferManagerV2}.\n   *\n   * @param abfsCounters the {@link AbfsCounters} used for read operations.\n   * @return the singleton instance of {@code ReadBufferManagerV2}.\n   */\n  static ReadBufferManagerV2 getBufferManager(AbfsCounters abfsCounters) {\n    if (!isConfigured.get()) {\n      throw new IllegalStateException(\"ReadBufferManagerV2 is not configured. \"\n          + \"Please call setReadBufferManagerConfigs() before calling getBufferManager().\");\n    }\n    if (bufferManager == null) {\n      LOCK.lock();\n      try {\n        if (bufferManager == null) {\n          bufferManager = new ReadBufferManagerV2(abfsCounters);\n          bufferManager.init();\n          LOGGER.trace(\"ReadBufferManagerV2 singleton initialized\");\n        }\n      } finally {\n        LOCK.unlock();\n      }\n    }\n    return bufferManager;\n  }\n\n  VectoredReadHandler getVectoredReadHandler() {","sourceCodeStart":137,"sourceCodeEnd":173,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-tools/hadoop-azure/src/main/java/org/apache/hadoop/fs/azurebfs/services/ReadBufferManagerV2.java#L137-L173","documentation":"Error \"ReadBufferManagerV2 is not configured. Please call setReadBufferManagerConfigs() before calling getBufferManager().\" thrown in apache/hadoop.","triggerScenarios":"getBufferManager() is invoked on ReadBufferManagerV2 before its configuration is set.","commonSituations":"See trigger scenarios.","solutions":["Call setReadBufferManagerConfigs() before getBufferManager() when using ReadBufferManagerV2 directly.","Through the ABFS driver, ensure filesystem initialization completes before reads."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"2add9630210752f88ceb1bb74eb65e37bf41da8e","analyzedAt":"2026-08-22T19:55:07.957Z","schemaVersion":2},"datasetVersion":"2026-08-22T20:17:22.307Z"}