.NET中使用SAS令牌下载Azure Blob的实现疑问及错误解决咨询

先看你这段代码里的几个关键问题，咱们一步步拆解：

1. SAS令牌的拼接方式可能有误 #

你直接把SAS令牌赋值给BlobUriBuilder.Query的做法容易出问题——因为SAS令牌本身通常是以?开头的（比如?sv=2023-11-03&ss=b&srt=o...），而UriBuilder.Query属性会自动处理前缀的?，如果直接赋值带?的令牌，最终生成的URI会出现多余的?，导致SAS令牌无效。

更稳妥的做法是直接用BlobClient的重载构造函数，分开传入Blob URI和SAS令牌，让SDK帮你处理拼接逻辑：

var blobClient = new BlobClient(blobUri, sasToken);

这种方式完全不用手动处理URI拼接，能避免格式错误。

2. 确认Blob URI指向的是具体Blob而非容器 #

要确保你的blobUri是具体Blob的完整URI（比如https://youraccount.blob.core.windows.net/yourcontainer/yourblob.txt），而不是容器的URI。如果指向的是容器，BlobClient会把容器当成Blob来处理，自然无法完成下载——容器不是可直接下载的Blob对象。

3. 异步方法调用的上下文问题 #

你用了await blobClient.DownloadToAsync(downloadFilePath)，但如果这段代码写在Main方法里，必须确保Main方法是异步的：

static async Task Main(string[] args)
{
    // 你的代码逻辑
}

同步方法里直接用await会触发编译器报错，因为同步上下文不支持异步等待。

修正后的完整示例代码 #

using Azure.Storage.Blobs;
using System;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        const string sasToken = "你的SAS令牌（开头带?也没关系，SDK会自动处理）";
        // 务必确保这个URI是具体Blob的完整地址
        var blobUri = new Uri("https://youraccount.blob.core.windows.net/yourcontainer/yourblob.txt");
        
        // 推荐使用的BlobClient构造方式
        var blobClient = new BlobClient(blobUri, sasToken);

        // 可选：先验证Blob是否存在，方便快速排查问题
        if (await blobClient.ExistsAsync())
        {
            Console.WriteLine("找到目标Blob: {0}", blobClient.Name);
        }
        else
        {
            Console.WriteLine("目标Blob不存在，请检查URI和SAS令牌权限");
            return;
        }

        // 准备本地存储路径，确保目录存在
        string localPath = "./data/";
        Directory.CreateDirectory(localPath);
        string fileName = "quickstart" + Guid.NewGuid().ToString() + ".txt";
        string downloadFilePath = Path.Combine(localPath, fileName.Replace(".txt", "_DOWNLOADED.txt"));

        // 执行下载操作
        var response = await blobClient.DownloadToAsync(downloadFilePath);
        Console.WriteLine("Blob下载成功！状态码: {0}", response.Status);
        Console.WriteLine("文件已保存到: {0}", downloadFilePath);
    }
}

额外排查点 #

• 检查SAS令牌权限：确保令牌包含r（读取）权限，且有效期未过期；
• 检查容器访问层级：如果容器是私有的，SAS令牌必须具备对应的访问权限；
• 确保本地目录存在：上面的代码加了Directory.CreateDirectory(localPath)，避免因路径不存在抛出错误。

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