{"record":{"id":"f151f3bf322ed1a6","repo":"apache/hadoop","slug":"failed-to-upload-key-part-idx-for-3-times","errorCode":null,"errorMessage":"Failed to upload {key}, part {idx} for 3 times.","messagePattern":"Failed to upload (.+?), part (.+?) for 3 times\\.","errorType":"exception","errorClass":"IOException","httpStatus":null,"severity":"error","filePath":"hadoop-tools/hadoop-aliyun/src/main/java/org/apache/hadoop/fs/aliyun/oss/AliyunOSSFileSystemStore.java","lineNumber":736,"sourceCode":"        uploadRequest.setBucketName(bucketName);\n        uploadRequest.setKey(key);\n        uploadRequest.setUploadId(uploadId);\n        uploadRequest.setInputStream(in);\n        uploadRequest.setPartSize(size);\n        uploadRequest.setPartNumber(idx);\n        UploadPartResult uploadResult = ossClient.uploadPart(uploadRequest);\n        statistics.incrementWriteOps(1);\n        return uploadResult.getPartETag();\n      } catch (Exception e) {\n        LOG.debug(\"Failed to upload \" + key + \", part \" + idx +\n            \"try again.\", e);\n        caught = e;\n      }\n      tries--;\n    }\n\n    assert (caught != null);\n    throw new IOException(\"Failed to upload \" + key + \", part \" + idx +\n        \" for 3 times.\", caught);\n  }\n\n  /**\n   * Initiate multipart upload.\n   * @param key object key.\n   * @return upload id.\n   */\n  public String getUploadId(String key) {\n    InitiateMultipartUploadRequest initiateMultipartUploadRequest =\n        new InitiateMultipartUploadRequest(bucketName, key);\n    InitiateMultipartUploadResult initiateMultipartUploadResult =\n        ossClient.initiateMultipartUpload(initiateMultipartUploadRequest);\n    return initiateMultipartUploadResult.getUploadId();\n  }\n\n  /**\n   * Complete the specific multipart upload.","sourceCodeStart":718,"sourceCodeEnd":754,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-tools/hadoop-aliyun/src/main/java/org/apache/hadoop/fs/aliyun/oss/AliyunOSSFileSystemStore.java#L718-L754","documentation":"Error \"Failed to upload {key}, part {idx} for 3 times.\" thrown in apache/hadoop.","triggerScenarios":"Thrown at hadoop-tools/hadoop-aliyun/src/main/java/org/apache/hadoop/fs/aliyun/oss/AliyunOSSFileSystemStore.java:736 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Verify OSS write permissions and bucket quota for the target key.","Check network stability to the OSS endpoint; the multipart part upload retried 3 times and failed, so inspect the root cause in the logs and retry the write."],"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-22T20:17:22.307Z"}