如何在ASP.NET Core 6 Minimal API返回分块text/plain格式JSONL流

要实现不加载全部数据到内存、保持分块传输（Transfer-Encoding: chunked）、Content-Type 为 text/plain且保留 JSONL 原始格式的需求，你需要绕过 ASP.NET Core 对 IAsyncEnumerable<string> 的默认 JSON 序列化行为，直接控制响应流和头信息。以下是两种可行方案：

方案一：逐行写入响应流（灵活可控） #

通过注入 HttpContext 直接操作响应流，逐行读取文件并写入客户端，确保数据实时分块发送：

app.MapGet("/stream/data", async (HttpContext context) =>
{
    // 设置响应 Content-Type 为 text/plain
    context.Response.ContentType = "text/plain";
    
    // 打开文件流读取 JSONL 内容
    using var fileReader = new StreamReader(filePath);
    // 绑定响应流的写入器（leaveOpen: true 避免提前关闭响应流）
    using var responseWriter = new StreamWriter(context.Response.Body, leaveOpen: true);
    
    while (!fileReader.EndOfStream)
    {
        var line = await fileReader.ReadLineAsync();
        if (line != null)
        {
            // 写入当前 JSON 行
            await responseWriter.WriteLineAsync(line);
            // 立即刷新流，确保数据分块发送到客户端
            await responseWriter.FlushAsync();
        }
    }
});

关键说明： #

• 直接控制 HttpContext.Response 避免了默认的 JSON 序列化（不会把结果包裹为数组或转义引号）
• 逐行读取和写入，无需加载整个文件到内存
• 未设置 Content-Length，ASP.NET Core 会自动启用 Transfer-Encoding: chunked
• 每次写入后调用 FlushAsync() 确保数据及时发送给客户端

方案二：直接返回文件流（高效简洁） #

如果无需对每行数据做额外处理，直接返回文件流是更高效的方式：

app.MapGet("/stream/data", () =>
{
    // 打开文件流（异步模式、共享读取）
    var fileStream = new FileStream(
        filePath, 
        FileMode.Open, 
        FileAccess.Read, 
        FileShare.Read, 
        bufferSize: 4096, 
        useAsync: true);
    
    // 返回流式结果，指定 Content-Type 为 text/plain
    return Results.Stream(
        fileStream, 
        contentType: "text/plain", 
        enableRangeProcessing: false);
});

关键说明： #

• ASP.NET Core 会自动处理流的释放和分块传输
• 直接返回原始文件流，完全保留 JSONL 的行格式
• 同样无需加载整个文件到内存，性能最优

为什么原代码不符合需求？ #

原代码返回 IAsyncEnumerable<string> 时，ASP.NET Core 会默认使用 SystemTextJsonSerializer 将其序列化为JSON 数组：

• 自动在所有元素外包裹 []
• 对每行的引号进行转义（比如 "key": "value" 变成 \"key\": \"value\"）
• 响应 Content-Type 被设为 application/json
  这完全破坏了 JSONL 的原始格式，也不符合流式处理的预期。

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