apache/hadoop · error · IOException

Remote filesystem for provided replica ${this} does not exis

Error message

Remote filesystem for provided replica ${this} does not exist

What it means

Error "Remote filesystem for provided replica ${this} does not exist" thrown in apache/hadoop.

Source

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

  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
  public URI getMetadataURI() {
    return null;
  }

  @Override
  public OutputStream getMetadataOutputStream(boolean append)
      throws IOException {

View on GitHub (pinned to 2add963021)

Solutions

1. Verify the external filesystem/URI configured for provided storage is reachable and correctly configured (fs.provided.* settings).
2. Check credentials and network access to the remote store backing the provided replica.

When it happens

Trigger: Accessing a provided replica whose backing remote filesystem cannot be resolved or connected.

Common situations: The remote filesystem backing a provided replica is unavailable. Verify the mount or object-store connector for the provided storage.

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