ASP.NET Core 3.1中使用IFormFile上传2KB文件异常求助

你遇到的这个小文件上传后变成0KB的问题，核心原因大概率是FileStream未被正确释放，导致内存缓冲区里的小文件数据没来得及写入磁盘。小文件体积小，数据会暂存在内存缓冲区中，如果流没有被正常关闭或刷新，这些数据就不会持久化到磁盘；而大文件因为超过了缓冲区大小，会分批次自动写入磁盘，所以能正常保存。

下面是具体的修正方案和优化建议：

1. 用using语句包裹FileStream（关键修复） #

using语句会自动帮你释放流资源，确保缓冲区的数据被强制写入磁盘。修改你的代码如下：

try 
{
    string baseDirectory = _env.WebRootPath;
    // 用Path.Combine拼接路径，避免手动拼串出现分隔符错误
    string filePath = Path.Combine(baseDirectory, "images", "services", file.FileName);
    
    // 使用using包裹FileStream，自动处理资源释放
    using (var stream = new FileStream(filePath, FileMode.Create))
    {
        // 推荐用异步方法，更适配Web应用的并发场景
        await file.CopyToAsync(stream);
        // 要是坚持用同步写法，也可以用：file.CopyTo(stream);
    }
    
    return Json($"/images/services/{file.FileName}");
} 
catch (Exception ex) 
{
    // 建议在这里记录异常详情，方便后续排查其他问题
    _logger.LogError(ex, "文件上传失败");
    return Json("0");
}

2. 额外优化建议 #

• 路径拼接用Path.Combine：代替手动拼接字符串，避免跨平台时的路径分隔符问题（比如Windows用\，Linux用/）。
• 优先使用异步方法：CopyToAsync不会阻塞请求线程，能提升Web应用的并发处理能力。
• 记录异常详情：不要只返回"0"，记录异常的堆栈信息，方便后续排查其他潜在问题。
• 确认写入权限：虽然你能创建文件说明权限基本没问题，但可以再检查一下目标文件夹是否有写入权限，避免特殊场景下的权限问题。

如果修改后还是有问题，可以尝试在CopyTo/CopyToAsync之后手动调用stream.Flush()（不过using语句会自动处理这一步），或者测试其他大小的小文件，确认是否是特定大小的文件触发问题。

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