You need to enable JavaScript to run this app. ASP.NET Core基于SqlDataReader返回FileStreamResult及异常修复
优惠活动
大模型
产品
解决方案
定价
更多

ASP.NET Core基于SqlDataReader返回FileStreamResult及异常修复

SQL Server大文件流式下载抛出SqlSequentialStream已释放异常

问题描述

我开发的ASP.NET Core项目具备下载存储在SQL Server中文件的功能。目前小文件下载运行正常,但大文件由于需要先全部加载到内存中再返回下载流,经常出现超时问题,因此我正在对该功能进行优化。
我参考SQL客户端流式支持的相关示例,将代码调整为如下版本:

public async Task<FileStreamResult> DownloadFileAsync(int id)
{
     ApplicationUser user = await _userManager.GetUserAsync(HttpContext.User);
     var file = await this._attachmentRepository.GetFileAsync(id);

     using (SqlConnection connection = new SqlConnection(this.ConnectionString))
     {
         await connection.OpenAsync();

         using (SqlCommand command = new SqlCommand("SELECT [Content] FROM [Attachments] WHERE [AttachmentId] = @id", connection))
        {
             command.Parameters.AddWithValue("id", file.AttachmentId);
             SqlDataReader reader = await command.ExecuteReaderAsync(CommandBehavior.SequentialAccess);

             if (await reader.ReadAsync())
             {
                 if (!(await reader.IsDBNullAsync(0)))
                 {
                     Stream stream = reader.GetStream(0);
                     var result = new FileStreamResult(stream, file.ContentType)
                     {
                         FileDownloadName = file.FileName
                     };

                     return result;
                 }
             }
         }
     }

     return null;   
 }

但测试运行时抛出如下异常:

Cannot access a disposed object. Object name: 'SqlSequentialStream'
请问该如何修复这个异常?

问题根源

异常的核心原因是资源生命周期不匹配:

  • ASP.NET Core 的 FileStreamResult 是延迟执行的,它不会在方法返回时立即读取流内容,而是等到后续响应处理管道执行时,才会从流中分段读取数据写入响应体。
  • 原代码中用 using 块包裹了 SqlConnection、SqlCommand 对象,当方法执行完 return 语句离开 using 作用域时,这些数据库连接、命令对象会被立即释放,底层依赖它们的 SqlSequentialStream 也会被同步标记为已释放。等后续管道真的去读取流内容时,就会抛出访问已释放对象的异常。

修复方案

不需要自定义复杂的流包装类,直接利用ASP.NET Core内置的资源注册机制即可:

  • 移除原代码中对 SqlConnection、SqlCommand、SqlDataReader 的 using 块,避免方法返回时就提前释放数据库资源
  • 把数据库相关对象、流对象的释放逻辑注册到请求生命周期中,等整个响应处理完成、流读取结束后,再统一释放资源
  • 对查询不到文件、文件内容为空的分支,手动释放已经打开的数据库资源,避免内存泄漏

修复后的代码参考:

public async Task<FileStreamResult> DownloadFileAsync(int id)
{
    var user = await _userManager.GetUserAsync(HttpContext.User);
    var file = await _attachmentRepository.GetFileAsync(id);

    // 手动管控数据库资源的释放时机,不提前用using块关闭
    var connection = new SqlConnection(this.ConnectionString);
    var command = new SqlCommand("SELECT [Content] FROM [Attachments] WHERE [AttachmentId] = @id", connection);
    command.Parameters.AddWithValue("@id", file.AttachmentId);
    
    await connection.OpenAsync();
    var reader = await command.ExecuteReaderAsync(CommandBehavior.SequentialAccess);

    // 无有效数据的分支,手动释放已打开的资源
    if (!await reader.ReadAsync() || await reader.IsDBNullAsync(0))
    {
        await reader.DisposeAsync();
        await command.DisposeAsync();
        await connection.DisposeAsync();
        return null;
    }

    var stream = reader.GetStream(0);
    // 注册到请求生命周期,响应处理完成后自动释放所有关联资源
    HttpContext.Response.RegisterForDisposeAsync(new IDisposable[] { stream, reader, command, connection });

    return new FileStreamResult(stream, file.ContentType)
    {
        FileDownloadName = file.FileName
    };
}

这种实现方式全程不会把大文件全部加载到内存,会按照缓冲区大小分段从SQL Server读取内容、分段写入响应,从根源上解决大文件下载的超时、内存占用过高的问题。


内容的提问来源于stack exchange,提问作者Greg Gum

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 14:36:04