{"record":{"id":"dd1b5bab1551c06c","repo":"apache/hadoop","slug":"vectored-read-failed-for-path-status","errorCode":null,"errorMessage":"Vectored read failed for path: {}, status={}","messagePattern":"Vectored read failed for path: (.+?), status=(.+?)","errorType":"exception","errorClass":"IOException","httpStatus":null,"severity":"error","filePath":"hadoop-tools/hadoop-azure/src/main/java/org/apache/hadoop/fs/azurebfs/services/ReadBufferManager.java","lineNumber":386,"sourceCode":"   * @param buffer the read buffer whose physical read has completed\n   * @param result the completion status of the physical read\n   * @param bytesActuallyRead number of bytes read from the backend\n   */\n  void handleVectoredCompletion(\n      ReadBuffer buffer,\n      ReadBufferStatus result,\n      int bytesActuallyRead) {\n    try {\n      if (result == ReadBufferStatus.AVAILABLE && bytesActuallyRead > 0) {\n        if (buffer.tryFanOut()) {\n          getVectoredReadHandler().fanOut(buffer, bytesActuallyRead);\n        }\n      } else {\n        LOGGER.debug(\n            \"Handling vectored completion for buffer with path: {}, offset: {}, length: {}, result: {}, bytesActuallyRead: {}\",\n            buffer.getPath(), buffer.getOffset(), buffer.getRequestedLength(),\n            result, bytesActuallyRead);\n        throw new IOException(\n            \"Vectored read failed for path: \" + buffer.getPath()\n                + \", status=\" + buffer.getStatus());\n      }\n    } catch (Exception e) {\n      // Fail all logical FileRange futures\n      getVectoredReadHandler().failBufferFutures(buffer, e);\n      buffer.setStatus(ReadBufferStatus.READ_FAILED);\n    } finally {\n      if (buffer.isFanOutDone()) {\n        // Must be cleared before publication / reuse\n        buffer.clearVectoredUnits();\n      }\n    }\n  }\n\n  abstract void clearFreeList();\n\n  void printTraceLog(String message, Object... args) {","sourceCodeStart":368,"sourceCodeEnd":404,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-tools/hadoop-azure/src/main/java/org/apache/hadoop/fs/azurebfs/services/ReadBufferManager.java#L368-L404","documentation":"Error \"Vectored read failed for path: {}, status={}\" thrown in apache/hadoop.","triggerScenarios":"A vectored read request to the storage service fails with the reported status.","commonSituations":"See trigger scenarios.","solutions":["Check storage availability and retry the vectored read.","Inspect the status in the message; for auth/permission errors fix credentials or ACLs."],"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-23T01:17:44.959Z"}