Azure.Storage.Blobs.BlobClient.ExistsAsync()调用抛无效字符异常问题

问题 #

环境 #

• .NET 6
• Azure.Storage.Blobs 12.20.0

代码示例 #

BlobContainerClient container = new BlobContainerClient(connectionString: blobConnection, blobContainerName: blobContainer);
BlobClient? blob = container.GetBlobClient(blobName: myBlobName);
using (MemoryStream? ms = new MemoryStream())
{
     await blob.DownloadToAsync(destination: ms); //此处无问题
}
bool exists = await blob.ExistsAsync(); //此处抛出异常

问题描述 #

已确认myBlobName是有效路径（调用DownloadToAsync可正常执行），但使用同一个BlobClient调用ExistsAsync时，会抛出路径包含无效字符的异常。最初先调用ExistsAsync再执行DownloadToAsync，即使确认Blob存在，ExistsAsync仍会报错；尝试使用两个不同BlobClient实例传入相同路径，结果一致。疑问：是函数使用方式有误，还是存在其他问题？

分析与解决 #

这种情况核心原因是ExistsAsync对Blob名称的校验逻辑比DownloadToAsync更严格，可按以下方向排查解决：

1. 清理Blob名称中的特殊字符
   Azure Blob存储对Blob名称有明确字符限制，部分特殊字符可能被下载接口兼容，但会被存在性校验拦截。需检查：

   • 替换全角字符、不可见控制字符（换行符、制表符等）
   • 确保路径使用正斜杠/，而非反斜杠\
   • 移除名称首尾的多余空格

2. 对Blob名称进行URL编码
   手动编码后再创建BlobClient，避免特殊字符触发校验：

   string encodedBlobName = Uri.EscapeDataString(myBlobName).Replace("%2F", "/");
   BlobClient? blob = container.GetBlobClient(encodedBlobName);
   

   注意保留正斜杠的替换，避免破坏路径结构。

3. 升级SDK版本
   Azure.Storage.Blobs 12.20.0可能存在校验逻辑的兼容性bug，尝试升级到最新稳定版（如12.22.x及以上）。

4. 用下载接口间接判断存在性
   若以上方法无效，可通过捕获DownloadToAsync的异常来判断Blob是否存在：

   bool exists = true;
   using (MemoryStream? ms = new MemoryStream())
   {
       try
       {
           await blob.DownloadToAsync(ms);
       }
       catch (RequestFailedException ex) when (ex.Status == 404)
       {
           exists = false;
       }
   }
   

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