如何正确使用C# Async Await？Azure Blob上传零字节问题求助

嘿，我完全懂你现在的困扰——Async异步方法的细节没拿捏准，导致上传到Azure Blob的文件变成了0字节。这种情况大多是因为异步操作没被正确等待，或者流的处理出了问题，咱们一步步来把它修好。

最常见的问题根源及修复方案 #

1. 遗漏了await关键字（最容易犯的错）

异步方法的核心就是等待操作完成，如果调用UploadAsync这类方法时没加await，代码会直接往下走，不等流传输完成就结束了，Blob自然是空的。

❌ 错误示例：

// 没加await，上传操作还没完成就跳过了
_blobService.UploadToBlobAsync(containerName, fileName, stream);

✅ 正确做法：

// 必须用await等待上传操作完成
await _blobService.UploadToBlobAsync(containerName, fileName, stream);

2. 流的Position没有重置到开头

如果你的流之前被读取过（比如IFormFile的流，或者自己创建的MemoryStream），流的指针会停在末尾，这时候上传的就是空内容。一定要在上传前把指针移到开头。

✅ 修复代码：

using var stream = file.OpenReadStream();
// 重置流位置到起始点
stream.Position = 0;
await _blobService.UploadToBlobAsync(containerName, fileName, stream);

3. 整个调用链没有保持异步

控制器方法、服务层方法都要标记为async，并且返回Task或Task<T>，不能在异步方法里用.Result或.Wait()这类同步阻塞的方式，这会导致死锁或者异步操作未完成。

✅ 控制器方法示例：

[HttpPost("upload")]
// 标记为async，返回Task<IActionResult>
public async Task<IActionResult> Upload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("请选择要上传的文件");

    using var stream = file.OpenReadStream();
    stream.Position = 0;

    // 等待服务层的异步方法完成
    await _blobUploadService.UploadFileAsync("my-container", file.FileName, stream);

    return Ok("文件上传成功");
}

✅ 服务层方法示例：

public async Task UploadFileAsync(string containerName, string blobName, Stream contentStream)
{
    var blobServiceClient = new BlobServiceClient(_connectionString);
    var containerClient = blobServiceClient.GetBlobContainerClient(containerName);
    await containerClient.CreateIfNotExistsAsync();

    var blobClient = containerClient.GetBlobClient(blobName);
    // 等待Blob上传完成，可加上overwrite参数覆盖已有文件
    await blobClient.UploadAsync(contentStream, overwrite: true);
}

额外注意事项 #

• 用using语句管理流的生命周期，确保流在上传完成后正确释放，但要注意await完成后再让using自动释放流。
• 避免在异步方法中使用同步阻塞调用（比如.Result、.Wait()），这会破坏异步流程，甚至导致死锁。
• 如果是使用MemoryStream，写入内容后一定要记得stream.Position = 0再上传。

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