apache/hadoop · error · IOException

ViewFs: Mount points initialization error. Invalid {targetMn

Error message

ViewFs: Mount points initialization error. Invalid {targetMntEntryKey} entry in config: {mntEntryKey}

What it means

Error "ViewFs: Mount points initialization error. Invalid {targetMntEntryKey} entry in config: {mntEntryKey}" thrown in apache/hadoop.

Source

Thrown at hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/viewfs/InodeTree.java:801

        if (o1 == null) {
          return -1;
        }
        if (o2 == null) {
          return 1;
        }
        String src1 = o1.getSrc();
        String src2=  o2.getSrc();
        return src1.compareTo(src2);
      }
    });
    sortedLinkEntries.addAll(linkEntries);
    return sortedLinkEntries;
  }

  private void checkMntEntryKeyEqualsTarget(
      String mntEntryKey, String targetMntEntryKey) throws IOException {
    if (!mntEntryKey.equals(targetMntEntryKey)) {
      throw new IOException("ViewFs: Mount points initialization error." +
          " Invalid " + targetMntEntryKey +
          " entry in config: " + mntEntryKey);
    }
  }

  private void addRegexMountEntry(LinkEntry le) throws IOException {
    LOGGER.info("Add regex mount point:" + le.getSrc()
        + ", target:" + le.getTarget()
        + ", interceptor settings:" + le.getSettings());
    RegexMountPoint regexMountPoint =
        new RegexMountPoint<T>(
            this, le.getSrc(), le.getTarget(), le.getSettings());
    regexMountPoint.initialize();
    regexMountPointList.add(regexMountPoint);
  }

  private LinkEntry buildLinkRegexEntry(
      Configuration config, UserGroupInformation ugi,

View on GitHub (pinned to 2add963021)

Solutions

1. Fix the mount table entry referenced in the message; its target configuration key is invalid.
2. Ensure each mount entry key maps to a valid target URI configuration.

When it happens

Trigger: Thrown during ViewFs mount point initialization when a mount entry (e.g. linkNfly) references an invalid or malformed entry in the configuration.

Common situations: See trigger scenarios.

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