Azure File Share中UploadRangeAsync追加文本时覆盖内容问题

问题原因 #

• CreateAsync覆盖了原有文件：该方法在目标文件已存在时，会直接创建新文件覆盖原有内容，这是导致原有文本丢失的核心原因。
• HttpRange起始偏移错误：HttpRange的起始位置从0开始计数，你使用currentFileLength - 1会导致写入位置错误，还会破坏原有文件的末尾内容。

正确实现代码 #

public async Task AppendAllTextAsync(string path, string text)
{
    var fileClient = _fileShare.GetRootDirectoryClient().GetFileClient(path);

    // 确保文件存在：不存在则创建空文件
    var exists = await fileClient.ExistsAsync();
    if (!exists)
    {
        await fileClient.CreateAsync(0);
    }

    // 获取当前文件的长度
    var fileProperties = await fileClient.GetPropertiesAsync();
    long currentLength = fileProperties.Value.ContentLength;

    byte[] textBytes = Encoding.UTF8.GetBytes(text);
    using (var ms = new MemoryStream(textBytes))
    {
        // 从文件末尾（currentLength位置）开始上传新内容，实现追加
        await fileClient.UploadRangeAsync(
            new HttpRange(currentLength, ms.Length),
            ms);
    }
}

关键细节说明 #

• 移除了对已有文件的CreateAsync调用，仅在文件不存在时创建空文件，彻底避免覆盖原有内容。
• 将HttpRange的起始位置设为currentLength，确保新内容从文件末尾开始写入，实现真正的追加效果。
• Azure Files的UploadRangeAsync会自动扩展文件大小，无需手动调用ResizeAsync，上传完成后文件长度会自动更新为currentLength + textBytes.Length。

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