如何用BlockBlobClient上传文件到文件夹？Azure Java SDK报错解决

问题根源 #

报错InvalidBlobOrBlock的核心原因是分块ID不符合Azure Blob存储的规范要求。当Blob名称包含路径格式时，如果你的分块上传逻辑中错误地将路径字符混入分块ID，或者分块ID未正确做Base64编码，就会触发该错误。Azure要求分块ID必须是Base64编码的字符串，且原始字符串不能包含控制字符或非法格式。

修正步骤 #

1. 确保Blob名称格式合规：Azure支持用斜杠/模拟文件夹结构，你示例中的20241024T180025/corey.jpg格式本身是合法的，只需确认实际代码中没有额外的空格、控制字符等非法内容。
2. 规范分块ID生成逻辑：分块ID必须唯一且经过Base64编码，建议用「序号+UUID」的方式生成原始字符串，避免路径字符干扰。
3. 修正分块上传代码：

String folder = "20241024T180025";
String filename = "corey.jpg";
String blobName = folder + "/" + filename;

BlobContainerClient containerClient = new BlobContainerClientBuilder()
        .connectionString(connectionString)
        .containerName(containerName)
        .buildClient();

BlockBlobClient blobClient = containerClient.getBlobClient(blobName).getBlockBlobClient();

// 分块上传核心逻辑
File localFile = new File("本地文件完整路径");
long fileSize = localFile.length();
long blockSize = 4 * 1024 * 1024; // 4MB分块大小，可根据需求调整
int blockCount = (int) (fileSize / blockSize) + (fileSize % blockSize == 0 ? 0 : 1);

List<String> blockIds = new ArrayList<>();

try (FileInputStream fis = new FileInputStream(localFile)) {
    for (int i = 0; i < blockCount; i++) {
        long offset = i * blockSize;
        long readLength = Math.min(blockSize, fileSize - offset);
        byte[] blockData = new byte[(int) readLength];
        fis.read(blockData);

        // 生成合规的分块ID：序号+UUID确保唯一，再做Base64编码
        String rawBlockId = "block-" + i + "-" + UUID.randomUUID();
        String encodedBlockId = Base64.getEncoder().encodeToString(rawBlockId.getBytes(StandardCharsets.UTF_8));
        blockIds.add(encodedBlockId);

        // 上传单个分块
        blobClient.stageBlock(encodedBlockId, new ByteArrayInputStream(blockData), readLength);
    }

    // 提交所有分块，完成文件上传
    blobClient.commitBlockList(blockIds);
} catch (IOException e) {
    e.printStackTrace();
}

额外注意事项 #

• 避免直接将Blob名称（含路径）作为分块ID的一部分，防止路径中的特殊字符导致编码异常。
• 确认你的Azure存储账户权限配置正确，确保有Blob的写入权限，排除权限问题引发的同类报错。

内容的提问来源于stack exchange，提问作者Corey