使用C#向Azure上传大文件时出现‘指定的块列表无效’错误

问题根源 #

你当前的代码存在三个核心问题：

1. 每次传块就立即提交：每次上传单个块后就调用CommitBlockListAsync，这会把当前块设为Blob的全部内容，之前上传的块会被覆盖或丢失。大文件分多块上传时，这种操作会导致提交的块列表不完整，触发无效列表错误。
2. 后端随机生成BlockId：用Guid生成的块ID无法保证顺序，前端也没法跟踪所有块的ID，最后提交的块列表要么顺序混乱，要么缺失部分块。
3. 没必要提前上传空Blob，StageBlockAsync本身就能创建Blob。

修正方案 #

1. 调整API交互逻辑 #

让前端传递三个关键参数：每个块的Base64格式唯一ID（带顺序标识）、当前块的索引、总块数。后端只负责暂存块，等所有块都传完再一次性提交完整的块列表。

2. 修正后的C#代码 #

[HttpPost("{fileName}")]
public async Task<IActionResult> UploadChunk(string fileName, [FromForm] ChunkUploadRequest request)
{
    if (request.Chunk == null || request.Chunk.Length == 0)
    {
        return BadRequest("未接收到文件块");
    }

    var blockBlobClient = blobContainerClient.GetBlockBlobClient(fileName);

    // 读取块内容到内存流
    using var stream = new MemoryStream();
    await request.Chunk.CopyToAsync(stream);
    stream.Position = 0;

    // 暂存当前块（使用前端传递的块ID）
    await blockBlobClient.StageBlockAsync(request.BlockId, stream);

    // 检查是否所有块都已上传完成
    if (request.CurrentChunkIndex + 1 == request.TotalChunks)
    {
        // 获取所有未提交的块
        var blockList = await blockBlobClient.GetBlockListAsync(BlockListTypes.Uncommitted);
        // 按块ID中的序号排序（需前端生成的ID包含顺序信息）
        var orderedBlockIds = blockList.Value.UncommittedBlocks
            .OrderBy(b => GetBlockOrderFromId(b.Name))
            .Select(b => b.Name)
            .ToList();

        // 提交完整的块列表
        await blockBlobClient.CommitBlockListAsync(orderedBlockIds);
        return Ok("文件上传完成");
    }

    return Ok("当前块上传成功");
}

// 接收前端参数的辅助类
public class ChunkUploadRequest
{
    public IFormFile Chunk { get; set; }
    public string BlockId { get; set; } // 前端生成的Base64格式块ID
    public int CurrentChunkIndex { get; set; } // 当前块索引（从0开始）
    public int TotalChunks { get; set; } // 总块数
}

// 从块ID中提取排序序号（示例，根据前端实际生成逻辑调整）
private int GetBlockOrderFromId(string base64BlockId)
{
    var blockIdBytes = Convert.FromBase64String(base64BlockId);
    var blockIdStr = Encoding.UTF8.GetString(blockIdBytes);
    // 假设块ID格式为"文件哈希_0001"，提取数字部分作为排序依据
    if (int.TryParse(blockIdStr.Split('_')[1], out int order))
    {
        return order;
    }
    return 0;
}

3. 关键细节说明 #

• 前端生成块ID：前端可以用文件的唯一哈希（比如MD5）加上块序号生成ID，比如abc123_0001，再转成Base64传给后端，这样既能保证同一文件的块ID唯一，又能通过序号排序。
• 延迟提交：只有当所有块都上传完成时，才调用CommitBlockListAsync提交完整列表，避免块丢失或覆盖。
• 块排序：提交前必须按正确顺序排列块ID，否则最终Blob的内容会混乱。

4. 前端配合要点 #

• 拆分文件时固定块大小（建议4MB，Azure块Blob单个块最大支持100MB）。
• 每个块生成带有序号的唯一ID，转成Base64后传递。
• 跟踪已上传的块，确保所有块都传完再触发后端的提交逻辑（或由后端根据总块数判断）。

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