如何在ASP.NET Core 8.0 Web API中禁用IAsyncEnumerable缓冲？

你的代码之所以会5秒后一次性返回所有结果，是因为ASP.NET Core默认会缓冲IAsyncEnumerable的输出，再加上JSON序列化数组时需要完整构建后才能返回，导致无法流式传输。以下是几种修改方案：

方案1：返回文本流（逐行输出数字） #

修改方法特性和返回类型，禁用缓存并输出带换行的文本，让客户端逐行接收：

[HttpGet("test")]
[ResponseCache(NoStore = true, Location = ResponseCacheLocation.None)]
public async IAsyncEnumerable<string> GetNumbers()
{
    Random rnd = new();

    foreach (var i in Enumerable.Range(0, 10))
    {
        await Task.Delay(500);
        yield return $"{rnd.Next(100)}\n";
    }
}

• [ResponseCache]特性用于禁用所有响应缓存，确保服务器不会攒齐结果再发送。
• 返回IAsyncEnumerable<string>并添加换行符，客户端可以按行读取每个数字。

方案2：返回NDJSON格式（流式JSON） #

如果需要保持JSON格式，可使用NDJSON（每行一个JSON对象），适合流式解析：

[HttpGet("test")]
[ResponseCache(NoStore = true, Location = ResponseCacheLocation.None)]
[Produces("application/x-ndjson")]
public async IAsyncEnumerable<string> GetNumbers()
{
    Random rnd = new();
    var jsonSerializer = System.Text.Json.JsonSerializer.Serialize;

    foreach (var i in Enumerable.Range(0, 10))
    {
        await Task.Delay(500);
        yield return jsonSerializer(rnd.Next(100)) + "\n";
    }
}

• [Produces]指定MIME类型为NDJSON，客户端可识别并逐行解析JSON。

方案3：直接操作响应流（底层控制） #

通过直接写入响应流并强制刷新，完全控制输出时机：

[HttpGet("test")]
public async Task GetNumbers()
{
    var response = HttpContext.Response;
    response.Headers.CacheControl = "no-cache";
    response.ContentType = "text/plain";

    Random rnd = new();
    await using var writer = new StreamWriter(response.Body);
    
    foreach (var i in Enumerable.Range(0, 10))
    {
        await Task.Delay(500);
        await writer.WriteLineAsync(rnd.Next(100).ToString());
        await writer.FlushAsync(); // 强制刷新缓冲区，立即发送内容到客户端
    }
}

这种方式绕过了框架的默认序列化和缓冲逻辑，直接控制输出流程。

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