.NET7+HotChocolate GraphQL：IAsyncEnumerable无法逐流返回问题

要让IAsyncEnumerable<string>的结果逐个即时返回，需完成以下配置与代码调整：

1. 启用HotChocolate流式查询支持 #

在Minimal API的服务注册中，显式开启流式响应与分块编码支持：

var builder = WebApplication.CreateBuilder(args);

builder.Services
    .AddGraphQLServer()
    .AddQueryType<Query>()
    // 启用流式查询核心支持
    .ModifyOptions(options =>
    {
        options.EnableStreaming = true;
    })
    // 配置HTTP传输支持分块响应
    .SetRequestOptions(options =>
    {
        options.EnableChunkedEncoding = true;
    });

var app = builder.Build();
app.MapGraphQL();
app.Run();

2. 定义查询类型并使用@stream指令 #

你的GetDummyNumbers方法逻辑无需修改，只需确保它属于Query类型：

public class Query
{
    public async IAsyncEnumerable<string> GetDummyNumbers()
    {
        for (var i = 0; i < 10; i++)
        {
            await Task.Delay(TimeSpan.FromSeconds(1));
            yield return i.ToString();
        }
    }
}

客户端查询时必须添加@stream指令，指定流式返回该字段：

query {
  dummyNumbers @stream(initialCount: 1)
}

initialCount:1表示立即返回第一个结果，后续结果会逐个推送至客户端。

3. 客户端兼容性验证 #

确保使用的GraphQL客户端支持流式响应（如Apollo Client、HotChocolate官方客户端），且请求采用HTTP/1.1（已启用分块编码）或HTTP/2协议，确保服务器可分块发送数据。

关键说明 #

• 默认IAsyncEnumerable不流式返回的原因：HotChocolate默认会缓冲IAsyncEnumerable的所有结果，必须显式启用流式支持并配合@stream指令才能触发分块返回。
• 流式查询与订阅的区别：流式查询基于单次HTTP请求的分块响应，完全匹配你"单次请求下流式返回"的需求；而订阅是WebSocket持续推送的实时数据方案，不符合场景。

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