{"record":{"id":"53ea176395465274","repo":"apache/hadoop","slug":"file-under-construction-found-without-clientnam","errorCode":null,"errorMessage":"<file-under-construction> found without <clientName>","messagePattern":"<file-under-construction> found without <clientName>","errorType":"exception","errorClass":"IOException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/tools/offlineImageViewer/OfflineImageReconstructor.java","lineNumber":694,"sourceCode":"    Node blocks = node.removeChild(INODE_SECTION_BLOCKS);\n    if (blocks != null) {\n      while (true) {\n        Node block = blocks.removeChild(INODE_SECTION_BLOCK);\n        if (block == null) {\n          break;\n        }\n        bld.addBlocks(createBlockBuilder(block));\n      }\n    }\n    Node fileUnderConstruction =\n        node.removeChild(INODE_SECTION_FILE_UNDER_CONSTRUCTION);\n    if (fileUnderConstruction != null) {\n      INodeSection.FileUnderConstructionFeature.Builder fb =\n          INodeSection.FileUnderConstructionFeature.newBuilder();\n      String clientName =\n          fileUnderConstruction.removeChildStr(INODE_SECTION_CLIENT_NAME);\n      if (clientName == null) {\n        throw new IOException(\"<file-under-construction> found without \" +\n            \"<clientName>\");\n      }\n      fb.setClientName(clientName);\n      String clientMachine =\n          fileUnderConstruction\n                  .removeChildStr(INODE_SECTION_CLIENT_MACHINE);\n      if (clientMachine == null) {\n        throw new IOException(\"<file-under-construction> found without \" +\n            \"<clientMachine>\");\n      }\n      fb.setClientMachine(clientMachine);\n      bld.setFileUC(fb);\n    }\n    Node acls = node.removeChild(INODE_SECTION_ACLS);\n    if (acls != null) {\n      bld.setAcl(aclXmlToProto(acls));\n    }\n    Node xattrs = node.removeChild(INODE_SECTION_XATTRS);","sourceCodeStart":676,"sourceCodeEnd":712,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/tools/offlineImageViewer/OfflineImageReconstructor.java#L676-L712","documentation":"Error \"<file-under-construction> found without <clientName>\" thrown in apache/hadoop.","triggerScenarios":"Thrown by oiv -r when a <file-under-construction> stanza lacks the required <clientName> element in the fsimage XML.","commonSituations":"See trigger scenarios.","solutions":["Add the missing <clientName> element to the <file-under-construction> stanza in the fsimage XML.","Regenerate the fsimage XML with 'hdfs oiv' from a valid fsimage instead of editing it by hand."],"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"}