apache/hadoop · error · IOException

PathHandle specified, but unsuported

Error message

PathHandle specified, but unsuported

What it means

Error "PathHandle specified, but unsuported" thrown in apache/hadoop.

Source

Thrown at hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/datanode/ProvidedReplica.java:194

      return new Path(pathSuffix).toUri();
    } else {
      return new Path(pathPrefix, pathSuffix).toUri();
    }
  }

  @Override
  public InputStream getDataInputStream(long seekOffset) throws IOException {
    if (remoteFS != null) {
      FSDataInputStream ins;
      try {
        if (pathHandle != null) {
          ins = remoteFS.open(pathHandle, conf.getInt(IO_FILE_BUFFER_SIZE_KEY,
              IO_FILE_BUFFER_SIZE_DEFAULT));
        } else {
          ins = remoteFS.open(new Path(getRemoteURI()));
        }
      } catch (UnsupportedOperationException e) {
        throw new IOException("PathHandle specified, but unsuported", e);
      }

      ins.seek(fileOffset + seekOffset);
      return new BoundedInputStream(
          new FSDataInputStream(ins), getBlockDataLength());
    } else {
      throw new IOException("Remote filesystem for provided replica " + this +
          " does not exist");
    }
  }

  @Override
  public OutputStream getDataOutputStream(boolean append) throws IOException {
    throw new UnsupportedOperationException(
        "OutputDataStream is not implemented for ProvidedReplica");
  }

  @Override

View on GitHub (pinned to 2add963021)

Solutions

1. Do not use PathHandle-based open with provided storage; the provided storage implementation does not support path handles.
2. Read provided replicas through standard streams instead of PathHandles.

When it happens

Trigger: A PathHandle (file-handle-based open) is requested for a ProvidedReplica backed by external storage that does not support handles.

Common situations: A PathHandle was supplied for an operation the provided-storage replica does not support. Remove PathHandle usage for provided replicas.

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