Web API中PushStreamContent未流式传输文件反而返回JSON的解决方法

你的问题出在ASP.NET Core框架会将HttpResponseMessage作为普通CLR对象序列化，而不是将其作为HTTP响应直接发送给客户端，所以才返回了序列化后的JSON内容。要实现流式传输，需要改用ASP.NET Core原生的IActionResult相关类型。

修改后的实现代码 #

[HttpGet("GetFile")]
public async Task<IActionResult> GetFile([FromQuery] string url)
{
    try
    {
        url = System.Web.HttpUtility.UrlDecode(url);
        // 使用using确保流资源被正确释放
        using var inputStream = await _httpClient.GetStreamAsync(url);
        
        // 替换正则，用更可靠的方式提取文件扩展名
        var uri = new Uri(url);
        var fileName = Path.GetFileName(uri.LocalPath);
        var ext = Path.GetExtension(fileName).TrimStart('.');
        
        // 确定响应的Content-Type
        var contentTypeProvider = new FileExtensionContentTypeProvider();
        if (!contentTypeProvider.TryGetContentType(fileName, out var contentType))
        {
            contentType = "application/octet-stream";
        }

        // 直接返回文件流，框架会自动处理流式传输
        return File(inputStream, contentType);
    }
    catch (Exception)
    {
        return StatusCode(StatusCodes.Status500InternalServerError);
    }
}

关键修改点说明 #

1. 返回类型替换：将Task<HttpResponseMessage>改为Task<IActionResult>，这是ASP.NET Core推荐的响应返回方式。
2. 流资源管理：用using包裹输入流，确保请求完成后流被正确释放，避免资源泄漏。
3. 扩展名与Content-Type优化：
   • 放弃易出错的正则表达式，改用Uri和Path类提取文件名与扩展名，兼容性更强。
   • 使用FileExtensionContentTypeProvider获取标准的MIME类型，比手动拼接application/{ext}更准确（比如PDF会自动识别为application/pdf，图片会识别为对应图片类型）。
4. 原生流式支持：File方法返回的FileStreamResult会自动处理流式传输逻辑，无需手动实现PushStreamContent的循环读写。

额外注意事项 #

• 确保_httpClient是通过依赖注入获取的（而非手动创建），避免HttpClient实例泛滥问题。
• 如果需要支持断点续传，可以额外添加Accept-Ranges和Content-Range头部，结合Range请求头实现分段传输。

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