.NET 10 新特性：ASP.NET Core Minimal API 实现 Server-Sent Events（SSE）实时推送详解

引言：.NET 10，实时推送新姿势 👀

.NET 10 和 ASP.NET Core 的持续进化总能给开发者带来惊喜。在 C# 14 与最新 Minimal API 支持下，Server-Sent Events（SSE）成为实现后端到前端单向实时推送的全新选择。无论你是正为直播新闻、股票行情、还是其他需要“只读”实时流的系统头疼，这篇文章都将让你事半功倍！

那么，SSE 到底是什么？和 SignalR、WebSocket 有啥不同？如何用最简洁的方式在 ASP.NET Core Minimal API 中落地？接下来，一文解锁！👇

一、Server-Sent Events（SSE）到底是什么？

SSE（Server-Sent Events）是一种基于 HTTP 协议的单向实时通信方式，由服务器主动向客户端推送事件，客户端只需订阅即可持续收到数据。SSE 适合用在：

• 实时新闻推送
• 股票、体育比分等行情应用
• 系统监控仪表盘等场景

SSE vs. SignalR vs. WebSocket，有啥不同？

总结：如果只需服务器推送数据给客户端，SSE 就是理想选择；如果需要双向通信或更复杂的交互，则推荐使用 SignalR。

二、ASP.NET Core Minimal API 如何实现 SSE？代码演示来啦！

1. SSE Endpoint 核心实现

.NET 10 开始，Minimal API 支持 TypedResults.ServerSentEvents，只需返回 IAsyncEnumerable<> 即可持续推送数据。

app.MapGet("/orders", (FoodService foods, CancellationToken token) =>
    TypedResults.ServerSentEvents(
        foods.GetCurrent(token),
        eventType: "order")
);

• foods.GetCurrent(token) 返回一个异步可枚举序列，用于源源不断地推送数据。
• eventType 指定事件类型，方便前端 JS 监听。

2. IAsyncEnumerable 服务端实现

如何让所有订阅者同步收到同一份数据？这就需要 FoodService 和后台定时更新的 FoodServiceWorker。

FoodService（状态管理+事件订阅）

public class FoodService : INotifyPropertyChanged
{
    public FoodService() { /* 初始化当前菜品 */ }

    // 当前推送的“食物”emoji
    private string Current { get; set; }

    public async IAsyncEnumerable<string> GetCurrent([EnumeratorCancellation] CancellationToken ct)
    {
        while (!ct.IsCancellationRequested)
        {
            yield return Current;
            var tcs = new TaskCompletionSource();
            PropertyChanged += (_, _) => tcs.SetResult();
            try { await tcs.Task.WaitAsync(ct); } finally { PropertyChanged -= handler; }
        }
    }

    public void Set() { /* 随机切换下一个食物 */ }
}

FoodServiceWorker（定时更新）

public class FoodServiceWorker(FoodService foodService) : BackgroundService
{
    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        while (!stoppingToken.IsCancellationRequested)
        {
            foodService.Set();
            await Task.Delay(1000, stoppingToken);
        }
    }
}

原理：每秒随机更新一次食物 emoji，通过事件通知所有订阅者，即时推送新内容。

三、前端：JavaScript 轻松接收 SSE 推送

只需几行 JS，即可完成客户端订阅与渲染！

<ul id="orders"></ul>
<script>
  const eventSource = new EventSource("/orders");
  const ordersList = document.getElementById("orders");

  eventSource.addEventListener("order", event => {
    const li = document.createElement("li");
    li.textContent = event.data;
    ordersList.appendChild(li);
  });

  eventSource.onerror = error => {
    console.error("EventSource failed:", error);
    eventSource.close();
  };
</script>

每次服务端变更，前端自动收到新 emoji。如果你同时打开多个页面，还能看到数据完全同步！

四、实战应用与优势总结

• 高效轻量：利用 HTTP 长连接，无需额外协议或复杂依赖。
• 易于集成：Minimal API + IAsyncEnumerable，自然融入 .NET 生态。
• 场景广泛：适合各种“只需服务器推送”的信息流项目。

结语 & 互动 🌟

Server-Sent Events 在 .NET 10 中的原生支持让实时应用开发变得更加简单高效。你有哪些实时推送需求？会考虑用 SSE 替代 SignalR 吗？或者你在项目中遇到过哪些有趣的“只读流”场景？欢迎在评论区留言讨论，或转发给身边感兴趣的小伙伴！