{"record":{"id":"3b3c90640291adbe","repo":"apache/hadoop","slug":"imgversion-expected-to-be","errorCode":null,"errorMessage":"imgVersion {} expected to be {}","messagePattern":"imgVersion (.+?) expected to be (.+?)","errorType":"exception","errorClass":"InconsistentFSStateException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/FSImageFormat.java","lineNumber":330,"sourceCode":"\n      StartupProgress prog = NameNode.getStartupProgress();\n      Step step = new Step(StepType.INODES);\n      prog.beginStep(Phase.LOADING_FSIMAGE, step);\n      long startTime = monotonicNow();\n\n      //\n      // Load in bits\n      //\n      MessageDigest digester = MD5Hash.getDigester();\n      DigestInputStream fin = new DigestInputStream(\n          Files.newInputStream(curFile.toPath()), digester);\n\n      DataInputStream in = new DataInputStream(fin);\n      try {\n        // read image version: first appeared in version -1\n        int imgVersion = in.readInt();\n        if (getLayoutVersion() != imgVersion) {\n          throw new InconsistentFSStateException(curFile, \n              \"imgVersion \" + imgVersion +\n              \" expected to be \" + getLayoutVersion());\n        }\n        boolean supportSnapshot = NameNodeLayoutVersion.supports(\n            LayoutVersion.Feature.SNAPSHOT, imgVersion);\n        if (NameNodeLayoutVersion.supports(\n            LayoutVersion.Feature.ADD_LAYOUT_FLAGS, imgVersion)) {\n          LayoutFlags.read(in);\n        }\n\n        // read namespaceID: first appeared in version -2\n        in.readInt();\n\n        long numFiles = in.readLong();\n\n        // read in the last generation stamp for legacy blocks.\n        long genstamp = in.readLong();\n        final BlockIdManager blockIdManager = namesystem.getBlockManager()","sourceCodeStart":312,"sourceCodeEnd":348,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/FSImageFormat.java#L312-L348","documentation":"Error \"imgVersion {} expected to be {}\" thrown in apache/hadoop.","triggerScenarios":"Loading an old (pre-protobuf) fsimage whose image version in the header does not match the expected layout version.","commonSituations":"See trigger scenarios.","solutions":["Load the image with the matching HDFS version or perform a proper upgrade.","Do not hand-edit fsimage files; regenerate a consistent image via checkpoint."],"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"}