API获取Dropbox存储PDF时出现ReadAsync读取操作冲突报错

核心问题分析 #

1. Stream被提前释放：你用using语句包裹了从GetStreamAsync获取的Stream，当方法返回FileStreamResult后，using块会立即释放Stream资源。但ASP.NET Core的响应管道需要后续异步读取这个Stream来生成响应，此时Stream已被释放，就会触发The ReadAsync method cannot be called when another read operation is pending错误。
2. HttpClient实例滥用：每次请求创建新的HttpClient实例会导致系统套接字耗尽，同时也不符合.NET的最佳实践。
3. 异常处理过于模糊：所有异常都返回NotFound，无法区分是路径不存在、网络请求失败还是其他内部错误，不利于排查问题。

修复后的代码 #

首先在项目的Program.cs中注册HttpClient服务（依赖注入）：

builder.Services.AddHttpClient();

然后修改你的控制器代码：

private readonly HttpClient _httpClient;

// 通过构造函数注入HttpClient
public YourControllerName(HttpClient httpClient)
{
    _httpClient = httpClient;
}

[HttpGet("{key}")]
public async Task<IActionResult> GetPDF(string key)
{
    string? path = GetPath(key);
    if (path == null)
    {
        return NotFound();
    }

    try
    {
        // 不要用using包裹Stream，交由FileStreamResult管理其生命周期
        Stream stream = await _httpClient.GetStreamAsync(path);
        return new FileStreamResult(stream, "application/pdf");
    }
    catch (HttpRequestException ex)
    {
        // 针对Dropbox请求失败的情况返回合适状态码
        return StatusCode(StatusCodes.Status502BadGateway, "无法连接到文件存储服务");
    }
    catch (Exception ex)
    {
        return StatusCode(StatusCodes.Status500InternalServerError, "服务器处理请求时出错");
    }
}

修复说明 #

• 移除Stream的using语句：ASP.NET Core的FileStreamResult会在响应完全写入客户端后自动释放Stream，无需手动用using管理。
• 复用HttpClient：通过依赖注入获取的HttpClient由框架维护连接池，避免频繁创建实例导致的资源浪费。
• 细化异常处理：区分网络请求异常和通用异常，返回更精准的状态码和提示信息，便于问题定位。

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