Azure上ASP.NET Core Web App的Server-Side Event响应缓冲问题

1. 无需创建API Management实例 #

你的问题根源是Azure App Service默认的响应缓冲机制，和API Management（APIM）无关。APIM是用于API网关管理的服务，你的应用没有使用APIM的话，完全不需要额外创建它来解决这个问题。

2. 可以仅针对SSE流关闭缓冲 #

完全可以针对SSE特定端点单独禁用缓冲，不用全局修改。具体实现方式：

• 在返回SSE响应的Action中，添加专属响应头，告知Azure App Service不要缓冲该响应：

public async Task GetSseStream()
{
    Response.Headers.ContentType = "text/event-stream";
    // 禁用客户端缓存
    Response.Headers.CacheControl = "no-cache, no-store";
    // 告知Azure App Service底层的nginx不缓冲响应
    Response.Headers["X-Accel-Buffering"] = "no";
    // 关闭ASP.NET Core自身的响应缓冲
    Response.Body.AllowBuffering = false;

    // 后续的SSE消息推送逻辑
}

• 不要给该端点添加[ResponseCache]特性，避免框架层面的缓存干预。

3. 更优解决方案推荐 #

除了针对端点配置响应头，还有这些更根本的优化方向：

• 确保流式响应配置正确：在.NET 6+的最小API中，直接在端点映射里设置流式相关配置，示例：

app.MapGet("/chat/sse", async context =>
{
    context.Response.Headers.ContentType = "text/event-stream";
    context.Response.Headers.CacheControl = "no-cache";
    context.Response.Headers["X-Accel-Buffering"] = "no";
    context.Response.Body.AllowBuffering = false;

    // 连接到消息队列或后台逻辑，推送实时消息
    while (!context.RequestAborted.IsCancellationRequested)
    {
        var message = await GetNextChatMessage();
        await context.Response.WriteAsync($"data: {JsonSerializer.Serialize(message)}\n\n");
        // 强制刷新响应流，确保消息立即发送
        await context.Response.Body.FlushAsync();
        await Task.Delay(1000, context.RequestAborted);
    }
})
.WithName("GetChatSseStream")
.WithOpenApi();

• 调整Azure App Service配置：在Azure门户的应用服务“配置”→“常规设置”中，确认启用HTTP/2（SSE在HTTP/2协议下的流式传输更稳定）；部分高级SKU支持直接关闭站点级的响应缓冲，不过优先推荐端点级配置。
• 移除dummy data临时方案：手动添加大量无效数据只是绕开缓冲的权宜之计，禁用缓冲才是长期、高效的解决方案。

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