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
相关产品推荐
相关产品推荐

