Visual Studio/Azure路径格式不支持：下载链接跳转错误页排查

我来帮你分析这个问题：你遇到的错误核心在于当前的下载逻辑不符合浏览器的文件下载机制——你的控制器返回的是JSON格式的路径字符串，但这个路径要么是服务器本地的绝对路径（比如C:\Files\test.pdf），浏览器根本无权访问服务器的本地文件系统；要么是Blob存储内部的路径，不是前端能直接解析的合法URL，所以才会触发“给定的路径格式不支持”的报错。

下面给你两种可行的解决方案，根据你的业务需求选择：

方案一：服务器直接返回文件流（推荐） #

这种方式不需要把Blob文件下载到服务器本地，直接从Blob存储读取文件流，返回给浏览器让用户直接下载，效率更高。

修改控制器代码 #

public async Task<IActionResult> DownloadBlob(string file, string extension)
{
    // 从Blob存储获取文件流和对应的ContentType
    var (fileStream, contentType) = await repo.DownloadBlobAsync(file, extension);
    // 设置下载时的文件名
    var downloadFileName = $"{file}.{extension}";
    
    // 返回FileResult，浏览器会自动触发下载
    return File(fileStream, contentType, downloadFileName);
}

修改Blob存储类的方法 #

调整DownloadBlobAsync，返回文件流和内容类型：

public async Task<(Stream Stream, string ContentType)> DownloadBlobAsync(string file, string fileExtension)
{
    // 获取Blob容器引用（替换成你的容器名）
    _cloudBlobContainerx = _cloudBlobClientx.GetContainerReference("your-container-name");
    // 拼接Blob文件名
    var blobFullName = $"{file}.{fileExtension}";
    var targetBlob = _cloudBlobContainerx.GetBlobReference(blobFullName);

    // 先获取Blob的元数据（包括ContentType）
    await targetBlob.FetchAttributesAsync();
    var contentType = targetBlob.Properties.ContentType ?? "application/octet-stream";

    // 将Blob内容读取到内存流中
    var memoryStream = new MemoryStream();
    await targetBlob.DownloadToStreamAsync(memoryStream);
    memoryStream.Position = 0; // 重置流的位置到开头，确保能正常读取

    return (memoryStream, contentType);
}

方案二：返回Blob的SAS下载URL #

如果需要让前端自己处理下载跳转，可以生成一个带SAS令牌的Blob公开下载URL，前端通过这个URL直接下载文件。

修改控制器代码 #

public async Task<IActionResult> DownloadBlob(string file, string extension)
{
    var sasDownloadUrl = await repo.GetBlobSasDownloadUrlAsync(file, extension);
    
    // 方式1：直接重定向到SAS URL，浏览器自动下载
    return Redirect(sasDownloadUrl);
    
    // 方式2：返回JSON给前端，让前端通过window.open或a标签跳转
    // return Json(new { downloadUrl = sasDownloadUrl });
}

修改Blob存储类的方法 #

新增/修改方法生成SAS URL：

public async Task<string> GetBlobSasDownloadUrlAsync(string file, string fileExtension)
{
    _cloudBlobContainerx = _cloudBlobClientx.GetContainerReference("your-container-name");
    var blobFullName = $"{file}.{fileExtension}";
    var targetBlob = _cloudBlobContainerx.GetBlobReference(blobFullName);

    // 构建SAS令牌，设置过期时间和只读权限
    var sasBuilder = new BlobSasBuilder
    {
        BlobContainerName = _cloudBlobContainerx.Name,
        BlobName = blobFullName,
        ExpiresOn = DateTimeOffset.UtcNow.AddHours(1) // 1小时后过期，可按需调整
    };
    // 只赋予读取权限，保证安全
    sasBuilder.SetPermissions(BlobSasPermissions.Read);

    // 生成带SAS令牌的下载URL
    var sasUri = targetBlob.GenerateSasUri(sasBuilder);
    return sasUri.ToString();
}

为什么原来的代码会报错？ #

你原来的控制器返回Json(downloadPath)，如果downloadPath是服务器本地的绝对路径，浏览器无法访问服务器的本地文件系统；如果是Blob存储的内部路径，那不是合法的URL格式，浏览器自然无法解析，就会抛出“给定的路径格式不支持”的错误。

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