{"record":{"id":"2a23c01ea7c198c9","repo":"apache/hadoop","slug":"no-md5-file-found-corresponding-to-image-file-ima","errorCode":null,"errorMessage":"No MD5 file found corresponding to image file {imageFile}","messagePattern":"No MD5 file found corresponding to image file (.+?)","errorType":"exception","errorClass":"java.io.IOException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/FSImage.java","lineNumber":949,"sourceCode":"          break;\n        }\n      }\n    } finally {\n      FSEditLog.closeAllStreams(editStreams);\n    }\n    return lastAppliedTxId - prevLastAppliedTxId;\n  }\n\n  /**\n   * Load the image namespace from the given image file, verifying\n   * it against the MD5 sum stored in its associated .md5 file.\n   */\n  private void loadFSImage(File imageFile, FSNamesystem target,\n      MetaRecoveryContext recovery, boolean requireSameLayoutVersion)\n      throws IOException {\n    MD5Hash expectedMD5 = MD5FileUtils.readStoredMd5ForFile(imageFile);\n    if (expectedMD5 == null) {\n      throw new IOException(\"No MD5 file found corresponding to image file \"\n          + imageFile);\n    }\n    loadFSImage(imageFile, expectedMD5, target, recovery,\n        requireSameLayoutVersion);\n  }\n  \n  /**\n   * Load in the filesystem image from file. It's a big list of\n   * filenames and blocks.\n   */\n  private void loadFSImage(File curFile, MD5Hash expectedMd5,\n      FSNamesystem target, MetaRecoveryContext recovery,\n      boolean requireSameLayoutVersion) throws IOException {\n    // BlockPoolId is required when the FsImageLoader loads the rolling upgrade\n    // information. Make sure the ID is properly set.\n    target.setBlockPoolId(this.getBlockPoolID());\n\n    FSImageFormat.LoaderDelegator loader = FSImageFormat.newLoader(conf, target);","sourceCodeStart":931,"sourceCodeEnd":967,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/FSImage.java#L931-L967","documentation":"Error \"No MD5 file found corresponding to image file {imageFile}\" thrown in apache/hadoop.","triggerScenarios":"Loading an fsimage file whose companion .md5 checksum file is missing from the storage directory.","commonSituations":"See trigger scenarios.","solutions":["Ensure the fsimage MD5 sidecar file is present alongside the image; re-transfer the image including its .md5 file.","Re-checkpoint from a healthy NameNode to regenerate image and MD5."],"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"}