如何配置Azure Function从HTTP请求中设置Blob文件名

你已经搞定了静态文件名的Blob上传功能，接下来要改成动态文件名（比如用上传文件的原名或者自定义命名规则），我这里有两种实用方案，适配不同场景：

方案1：通过路由参数指定文件名（简洁高效） #

这种方法适合前端可以提前确定文件名的场景，我们修改HTTP触发器的路由，把文件名作为路由参数，直接绑定到Blob路径上：

public static class Uploader {
    [FunctionName("Uploader")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "post", Route = "upload/{filename}")] HttpRequest req,
        [Blob("hello/{filename}", FileAccess.Write)] Stream writer,
        string filename,
        ILogger log
    ) {
        log.LogInformation("开始处理文件上传，目标文件名：{Filename}", filename);
        
        // 验证请求格式是否正确
        if (!req.ContentType.StartsWith("multipart/form-data")) {
            return new BadRequestObjectResult("请使用multipart/form-data格式上传文件");
        }
        
        // 直接流式写入Blob，无需内存缓存
        await req.Body.CopyToAsync(writer);
        return new OkObjectResult($"文件 {filename} 已成功上传至 hello/{filename}");
    }
}

注意点： #

• 路由中的{filename}会自动映射到方法参数的filename，Blob绑定里的{filename}会动态替换为这个值
• 如果文件名包含空格或特殊字符，前端需要对文件名做URL编码（比如my photo.jpg要转成my%20photo.jpg）
• 这种流式上传方式内存占用极低，适合大文件场景

方案2：从表单数据中获取文件名（贴合常规上传体验） #

如果是前端用<input type="file">这类控件上传，文件名会包含在multipart表单的Content-Disposition里，我们可以手动解析表单获取文件名，再用Azure Blob SDK上传：

首先需要安装Azure.Storage.Blobs NuGet包，然后修改代码：

using Azure.Storage.Blobs;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.Extensions.Logging;
using System.IO;
using System.Threading.Tasks;

public static class Uploader {
    [FunctionName("Uploader")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "post", Route = null)] HttpRequest req,
        ILogger log
    ) {
        log.LogInformation("触发文件上传流程...");
        
        if (!req.ContentType.StartsWith("multipart/form-data")) {
            return new BadRequestObjectResult("无效的请求格式，请使用multipart/form-data");
        }
        
        // 解析multipart表单内容
        var reader = new MultipartReader(req.ContentType, req.Body);
        var section = await reader.ReadNextSectionAsync();
        
        while (section != null) {
            // 判断当前区块是否为文件部分
            var hasFileName = !string.IsNullOrEmpty(section.ContentDisposition?.FileName.Value);
            if (hasFileName) {
                // 提取并清洗文件名（去掉前后引号）
                var fileName = section.ContentDisposition.FileName.Value.Trim('"');
                
                // 可选：生成唯一文件名，避免同名文件覆盖
                var uniqueFileName = $"{System.Guid.NewGuid()}_{fileName}";
                
                // 初始化Blob客户端
                var blobServiceClient = new BlobServiceClient(Environment.GetEnvironmentVariable("AzureWebJobsStorage"));
                var containerClient = blobServiceClient.GetBlobContainerClient("hello");
                await containerClient.CreateIfNotExistsAsync(); // 确保容器存在
                
                // 上传文件到Blob存储
                var blobClient = containerClient.GetBlobClient(uniqueFileName);
                await blobClient.UploadAsync(section.Body, overwrite: true);
                
                return new OkObjectResult($"文件 {fileName} 已成功上传至 hello/{uniqueFileName}");
            }
            
            section = await reader.ReadNextSectionAsync();
        }
        
        return new BadRequestObjectResult("请求中未找到上传的文件");
    }
}

优势： #

• 无需在URL中传递文件名，完全符合前端常规文件上传的交互逻辑
• 可以轻松实现文件名去重（比如加GUID前缀），避免覆盖已有文件
• 支持同时上传多个文件（只需在循环中处理每个文件区块即可）

通用注意事项 #

• 确保Azure Function配置了正确的AzureWebJobsStorage连接字符串，指向目标Blob存储账户
• 大文件上传优先选择方案1的流式绑定，内存占用更低
• 可根据业务需求自定义文件名规则，比如添加时间戳、用户ID等前缀

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