C#使用Azure Blob数据移动库上传时如何设置正确Content-Type

Azure Storage Data Movement 库默认不会自动根据文件扩展名映射对应MIME类型，所有通过UploadDirectoryAsync上传的文件，Content-Type会被默认设置为application/octet-stream，库本身没有提供自动匹配Content-Type的开关配置，需要通过上传回调手动给每个文件设置对应属性。

核心是利用DirectoryTransferContext提供的SetAttributesCallback回调，该回调会在每个文件开始上传前触发，允许你自定义目标Blob的各类属性，包括Content-Type。

• 推荐使用.NET官方提供的FileExtensionContentTypeProvider做标准MIME类型映射，不需要手动维护大量扩展名对照关系，需要先给项目安装Microsoft.AspNetCore.StaticFilesNuget包（非Web项目也可以正常引用这个包）。
• 如果不想引入额外依赖，也可以自己维护常用文件扩展名和Content-Type的对照字典，覆盖业务场景用到的文件类型即可。

1. 首先在类级别声明MIME映射实例，避免重复创建开销：

// 用官方MIME映射提供器
private static readonly FileExtensionContentTypeProvider ContentTypeProvider = new FileExtensionContentTypeProvider();

// 如果自己维护字典就用下面这段替换上面的
// private static readonly Dictionary<string, string> MimeMappings = new(StringComparer.OrdinalIgnoreCase)
// {
//     {".html", "text/html"},
//     {".css", "text/css"},
//     {".js", "application/javascript"},
//     {".json", "application/json"},
//     {".png", "image/png"},
//     {".jpg", "image/jpeg"},
//     {".jpeg", "image/jpeg"},
//     {".gif", "image/gif"},
//     {".svg", "image/svg+xml"},
//     {".txt", "text/plain"}
// };

2. 修改GetDirectoryTransferContext方法，注册属性设置回调，原有其他逻辑（比如进度回调、失败重试、断点续传配置）全部保留即可：

public static DirectoryTransferContext GetDirectoryTransferContext(TransferCheckpoint checkpoint)
{
    DirectoryTransferContext context = new DirectoryTransferContext(checkpoint);
    
    // 新增：注册上传前属性设置回调
    context.SetAttributesCallback = (sourcePath, destinationBlob) =>
    {
        if (destinationBlob is CloudBlockBlob blockBlob)
        {
            string localFile = sourcePath as string;
            if (!string.IsNullOrWhiteSpace(localFile))
            {
                // 官方提供器匹配逻辑
                if (ContentTypeProvider.TryGetContentType(localFile, out string contentType))
                {
                    blockBlob.Properties.ContentType = contentType;
                }
                else
                {
                    // 未匹配到的类型可以自定义默认值
                    blockBlob.Properties.ContentType = "application/octet-stream";
                }

                // 自己维护字典的话把上面的逻辑替换成下面这段
                // string ext = Path.GetExtension(localFile);
                // if (!string.IsNullOrEmpty(ext) && MimeMappings.TryGetValue(ext, out string contentType))
                // {
                //     blockBlob.Properties.ContentType = contentType;
                // }
                // else
                // {
                //     blockBlob.Properties.ContentType = "application/octet-stream";
                // }
            }
        }
        return Task.CompletedTask;
    };

    // 这里保留你原来的context配置，比如进度回调、失败处理逻辑
    return context;
}

3. 原有的UploadDirectoryAsync调用逻辑、UploadDirectoryOptions配置不需要做任何修改，调整后上传的文件就会自动匹配对应Content-Type。

注意：如果你的上传目标包含页Blob、追加Blob，只需要在回调里加对应类型的判断和属性赋值逻辑即可，逻辑和块Blob完全一致。

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