{"record":{"id":"5c5bb6aedf4f5ce0","repo":"apache/hadoop","slug":"mount-table-mounttablename-has-already-been-conf","errorCode":null,"errorMessage":"Mount table {mountTableName} has already been configured with a merge slash link. A regular link should not be added.","messagePattern":"Mount table (.+?) has already been configured with a merge slash link\\. A regular link should not be added\\.","errorType":"validation","errorClass":"IOException","httpStatus":null,"severity":"error","filePath":"hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/viewfs/InodeTree.java","lineNumber":697,"sourceCode":"        // src\n\n        linkType = LinkType.NFLY;\n      } else if (src.startsWith(Constants.CONFIG_VIEWFS_LINK_REGEX)) {\n        linkEntries.add(\n            buildLinkRegexEntry(config, ugi, src, si.getValue()));\n        continue;\n      } else if (src.startsWith(Constants.CONFIG_VIEWFS_HOMEDIR)) {\n        // ignore - we set home dir from config\n        continue;\n      } else {\n        throw new IOException(\"ViewFs: Cannot initialize: Invalid entry in \" +\n            \"Mount table in config: \" + src);\n      }\n\n      final String target = si.getValue();\n      if (linkType != LinkType.MERGE_SLASH) {\n        if (isMergeSlashConfigured) {\n          throw new IOException(\"Mount table \" + mountTableName\n              + \" has already been configured with a merge slash link. \"\n              + \"A regular link should not be added.\");\n        }\n        linkEntries.add(\n            new LinkEntry(src, target, linkType, settings, ugi, config));\n      } else {\n        if (!linkEntries.isEmpty()) {\n          throw new IOException(\"Mount table \" + mountTableName\n              + \" has already been configured with regular links. \"\n              + \"A merge slash link should not be configured.\");\n        }\n        if (isMergeSlashConfigured) {\n          throw new IOException(\"Mount table \" + mountTableName\n              + \" has already been configured with a merge slash link. \"\n              + \"Multiple merge slash links for the same mount table is \"\n              + \"not allowed.\");\n        }\n        isMergeSlashConfigured = true;","sourceCodeStart":679,"sourceCodeEnd":715,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/viewfs/InodeTree.java#L679-L715","documentation":"Error \"Mount table {mountTableName} has already been configured with a merge slash link. A regular link should not be added.\" thrown in apache/hadoop.","triggerScenarios":"Thrown during ViewFs mount table initialization when a merge-slash link is added to a mount table that was already configured with a merge slash link; only regular links may follow.","commonSituations":"See trigger scenarios.","solutions":["Do not add regular links to a mount table already configured with a merge slash link.","Remove either the linkMergeSlash entry or the regular link entries for that mount table in the configuration."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"2add9630210752f88ceb1bb74eb65e37bf41da8e","analyzedAt":"2026-08-22T19:55:07.957Z","schemaVersion":2},"datasetVersion":"2026-08-23T01:17:44.959Z"}