.NET Web API中如何显示Google Drive大文件的下载进度？

你的问题根源在于先将整个大文件写入MemoryStream缓冲，再返回给客户端——这会导致浏览器要等到文件完全加载到服务器内存后，才能收到响应头并弹出保存对话框，期间页面处于冻结状态。要实现实时进度显示，核心思路是避免全量内存缓冲，直接将下载流分块传输给客户端，同时提前发送必要的响应头让浏览器感知文件信息。

解决方案步骤 #

1. 先获取Google Drive文件的元数据（包括文件大小），用于设置响应头的Content-Length，让浏览器能计算准确的下载进度。
2. 直接将Google Drive的下载流写入ASP.NET Core的响应输出流（Response.Body），跳过MemoryStream的全量缓冲，实现边下载边返回的流式传输。
3. 提前设置Content-Type、Content-Disposition等响应头，确保浏览器立刻触发下载流程并显示进度。

修改后的代码示例 #

public async Task<IActionResult> DownloadById([FromRoute] string id)
{
    try
    {
        // 获取文件元数据，拿到文件名和大小
        var fileMetadata = await drive.Files.Get(id).ExecuteAsync();
        var fileName = fileMetadata.Name ?? "test.zip";
        var fileSize = fileMetadata.Size;

        // 设置响应头，让浏览器立即识别下载请求
        Response.ContentType = "application/octet-stream";
        Response.Headers.ContentDisposition = new ContentDispositionHeaderValue("attachment")
        {
            FileName = fileName
        }.ToString();
        
        // 如果能获取到文件大小，设置Content-Length，让浏览器显示准确进度
        if (fileSize.HasValue)
        {
            Response.ContentLength = fileSize.Value;
        }

        // 直接将Google Drive的流写入响应输出流，无内存缓冲
        await drive.Files.Get(id).DownloadAsync(Response.Body);

        return new EmptyResult();
    }
    catch (GoogleApiException ex)
    {
        // 处理文件不存在或权限问题等异常
        return StatusCode((int)ex.HttpStatusCode, ex.Message);
    }
}

关键说明 #

• 流式传输：通过直接写入Response.Body，服务器不需要把整个文件加载到内存，而是从Google Drive读取一部分数据，就立刻返回给客户端，内存占用极低，同时浏览器能实时更新下载进度。
• 响应头提前发送：先设置好Content-Disposition和Content-Length，浏览器收到这些头信息后会立刻弹出保存对话框，不需要等到文件完全下载。
• 兼容性：Google Drive的.NET客户端库支持直接将下载流写入任意Stream，Response.Body是ASP.NET Core提供的响应输出流，完全适配这种场景。

注意事项 #

• 如果某些Google Drive文件无法获取到Size（比如动态生成的文件），可以去掉Content-Length的设置，此时浏览器会显示"未知进度"，但依然能实时更新已下载的字节数。
• 确保你的ASP.NET Core应用没有启用全局响应缓冲（默认情况下大文件会自动禁用缓冲，但可以通过配置确认）。
• 记得添加异常处理，捕获Google API调用可能出现的错误（如文件不存在、权限不足等），返回合适的HTTP状态码。

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