使用OutputStream.Write分块下载大文件时无法浏览站点的问题

首先，你的核心问题大概率是**ASP.NET会话锁定（Session Locking）**导致的。默认情况下，ASP.NET会对同一个用户会话（Session）的请求加独占锁——当你的下载请求在处理时，同一个Session的其他页面请求会被排队等待，直到下载请求释放Session锁，这就是为什么下载过程中没法浏览站点的原因。下面是针对性的解决方案：

1. 禁用下载请求的Session锁 #

如果你的下载处理程序不需要访问Session数据，或者只需要只读访问，你可以通过实现特定接口来让ASP.NET不施加Session锁：

• 如果你完全不需要Session：只实现IHttpHandler即可，不要添加任何Session相关接口。
• 如果需要只读访问Session：实现IReadOnlySessionState接口（位于System.Web.SessionState命名空间）。

修改你的ASHX处理程序类：

using System.Web.SessionState;

public class DownloadFileHandler : IHttpHandler, IReadOnlySessionState
{
    public void ProcessRequest(HttpContext context)
    {
        HttpResponse response = context.Response;
        Int32 chunkSize = AppSettings.DownloadChunkSizeMb * 1024 * 1024;
        Int32 filePosition = 0;

        // 配置响应头（示例）
        response.ContentType = "application/octet-stream";
        response.AddHeader("Content-Disposition", $"attachment; filename=\"{Metadata.FileName}\"");
        response.BufferOutput = false; // 关键：禁用输出缓冲，直接发送分块

        while (filePosition < Metadata.Size)
        {
            Byte[] chunk = GetFileChunkFromDatabase(filePosition, chunkSize); // 从数据库获取块
            if (!response.IsClientConnected)
            {
                break; // 客户端断开则终止下载
            }
            response.OutputStream.Write(chunk, 0, chunk.Length);
            response.Flush(); // 立即发送当前块到客户端
            filePosition += chunk.Length;
        }
    }

    public bool IsReusable => true;
}

实现IReadOnlySessionState后，ASP.NET会给请求加共享锁而非独占锁，同一个Session的其他请求可以并行处理；如果完全不实现Session接口，请求不会获取任何Session锁，彻底避免阻塞。

2. 改用异步处理释放线程 #

如果你的数据库查询耗时较长，可以用异步方式获取文件块，这样能释放ASP.NET线程池中的线程，让服务器可以处理更多其他请求：

将ASHX改为异步处理逻辑：

public class DownloadFileHandler : IHttpHandler
{
    public async void ProcessRequest(HttpContext context)
    {
        HttpResponse response = context.Response;
        Int32 chunkSize = AppSettings.DownloadChunkSizeMb * 1024 * 1024;
        Int32 filePosition = 0;

        response.ContentType = "application/octet-stream";
        response.AddHeader("Content-Disposition", $"attachment; filename=\"{Metadata.FileName}\"");
        response.BufferOutput = false;

        while (filePosition < Metadata.Size)
        {
            // 异步从数据库获取块，避免阻塞线程
            Byte[] chunk = await GetFileChunkFromDatabaseAsync(filePosition, chunkSize);
            if (!response.IsClientConnected)
            {
                break;
            }
            // 异步写入输出流
            await response.OutputStream.WriteAsync(chunk, 0, chunk.Length);
            response.Flush();
            filePosition += chunk.Length;
        }
    }

    public bool IsReusable => true;
}

异步处理能让服务器在等待数据库响应时，把线程放回线程池处理其他请求，提升站点的并发能力。

3. 验证分块传输配置 #

确保响应头正确启用分块传输，ASP.NET在设置BufferOutput = false并多次调用Flush()时会自动启用Transfer-Encoding: chunked，你也可以显式设置：

response.AddHeader("Transfer-Encoding", "chunked");

这能让浏览器明确知道数据是分块发送的，避免不必要的缓冲。

为什么单独开线程下载没用？ #

问题的根源是Session锁，而非线程本身——即使你在另一个线程处理下载，ASP.NET的Session锁仍然会被当前请求持有，直到整个请求处理完成，所以其他同Session的请求还是会被阻塞。只有释放Session锁或者使用无Session的请求才能解决这个问题。

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