apache/hadoop · error · IOException

Vectored read failed for path: {}, status={}

Error message

Vectored read failed for path: {}, status={}

What it means

Error "Vectored read failed for path: {}, status={}" thrown in apache/hadoop.

Source

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

   * @param buffer the read buffer whose physical read has completed
   * @param result the completion status of the physical read
   * @param bytesActuallyRead number of bytes read from the backend
   */
  void handleVectoredCompletion(
      ReadBuffer buffer,
      ReadBufferStatus result,
      int bytesActuallyRead) {
    try {
      if (result == ReadBufferStatus.AVAILABLE && bytesActuallyRead > 0) {
        if (buffer.tryFanOut()) {
          getVectoredReadHandler().fanOut(buffer, bytesActuallyRead);
        }
      } else {
        LOGGER.debug(
            "Handling vectored completion for buffer with path: {}, offset: {}, length: {}, result: {}, bytesActuallyRead: {}",
            buffer.getPath(), buffer.getOffset(), buffer.getRequestedLength(),
            result, bytesActuallyRead);
        throw new IOException(
            "Vectored read failed for path: " + buffer.getPath()
                + ", status=" + buffer.getStatus());
      }
    } catch (Exception e) {
      // Fail all logical FileRange futures
      getVectoredReadHandler().failBufferFutures(buffer, e);
      buffer.setStatus(ReadBufferStatus.READ_FAILED);
    } finally {
      if (buffer.isFanOutDone()) {
        // Must be cleared before publication / reuse
        buffer.clearVectoredUnits();
      }
    }
  }

  abstract void clearFreeList();

  void printTraceLog(String message, Object... args) {

View on GitHub (pinned to 2add963021)

Solutions

1. Check storage availability and retry the vectored read.
2. Inspect the status in the message; for auth/permission errors fix credentials or ACLs.

When it happens

Trigger: A vectored read request to the storage service fails with the reported status.

Common situations: See trigger scenarios.

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