apache/hadoop · error · UnsupportedFileSystemException

No FileSystem for scheme "{}"

Error message

No FileSystem for scheme "{}"

What it means

Error "No FileSystem for scheme "{}"" thrown in apache/hadoop.

Source

Thrown at hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/FileSystem.java:3585

    }
    LOGGER.debug("Looking for FS supporting {}", scheme);
    Class<? extends FileSystem> clazz = null;
    if (conf != null) {
      String property = "fs." + scheme + ".impl";
      LOGGER.debug("looking for configuration option {}", property);
      clazz = (Class<? extends FileSystem>) conf.getClass(
          property, null);
    } else {
      LOGGER.debug("No configuration: skipping check for fs.{}.impl", scheme);
    }
    if (clazz == null) {
      LOGGER.debug("Looking in service filesystems for implementation class");
      clazz = SERVICE_FILE_SYSTEMS.get(scheme);
    } else {
      LOGGER.debug("Filesystem {} defined in configuration option", scheme);
    }
    if (clazz == null) {
      throw new UnsupportedFileSystemException("No FileSystem for scheme "
          + "\"" + scheme + "\"");
    }
    if (LOGGER.isDebugEnabled()) {
      LOGGER.debug("FS for {} is {}", scheme, clazz);
      final String jarLocation = ClassUtil.findContainingJar(clazz);
      if (jarLocation != null) {
        LOGGER.debug("Jar location for {} : {}", clazz, jarLocation);
      } else {
        LOGGER.debug("Class location for {} : {}", clazz, ClassUtil.findClassLocation(clazz));
      }
    }
    return clazz;
  }

  /**
   * Create and initialize a new instance of a FileSystem.
   * @param uri URI containing the FS schema and FS details
   * @param conf configuration to use to look for the FS instance declaration

View on GitHub (pinned to 2add963021)

Solutions

1. Add the filesystem implementation class to core-site.xml: fs.<scheme>.impl.
2. Ensure the jar providing the scheme's FileSystem is on the classpath.
3. Check the URI scheme for typos (e.g. hdfs vs. file).

When it happens

Trigger: Thrown at hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/FileSystem.java:3585 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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