Azure上C#应用发布Webhook的正确方式及工具选型咨询

一、推荐的NuGet包 #

1. ASP.NET Core WebHooks SDK（Microsoft.AspNetCore.WebHooks） #

这是官方针对ASP.NET Core推出的SDK，专门简化Webhook的推送与接收实现，内置签名验证、重试机制、事件订阅管理等核心能力，无需手动处理HTTP请求的底层细节。

• 核心优势：支持标准化Webhook事件格式，自动处理请求签名以防止篡改，内置重试策略保障消息送达可靠性。
• 极简使用示例：

  // 注册服务
  builder.Services.AddWebHooks().AddWebHookSender();
  
  // 注入IWebHookSender实现事件推送
  public class EventPublisher
  {
      private readonly IWebHookSender _webHookSender;
  
      public EventPublisher(IWebHookSender webHookSender)
      {
          _webHookSender = webHookSender;
      }
  
      public async Task PushOrderCreatedEvent(string targetUrl, Order order)
      {
          var workItem = new WebHookWorkItem
          {
              WebHook = new WebHook
              {
                  Uri = new Uri(targetUrl),
                  Secret = "your-signing-secret"
              },
              Data = new
              {
                  EventType = "Order.Created",
                  OrderId = order.Id,
                  Timestamp = DateTime.UtcNow
              }
          };
  
          await _webHookSender.SendWebHookAsync(workItem);
      }
  }
  

2. Flurl.Http #

如果需要轻量、灵活的HTTP请求封装，Flurl.Http是理想选择。它通过链式调用简化HTTP代码，配合自定义逻辑可快速实现Webhook推送，适合无需复杂管理功能的场景。

• 核心优势：简洁的链式语法，自动JSON序列化/反序列化，支持自定义超时、重试配置。
• 极简使用示例：

  using Flurl.Http;
  
  public async Task SendWebhookEvent(string targetUrl, object eventData)
  {
      await targetUrl
          .WithHeader("Content-Type", "application/json")
          .WithHeader("X-Event-Type", "Order.Updated")
          .PostJsonAsync(eventData)
          .RetryOnFail(3, TimeSpan.FromSeconds(2)); // 自定义重试次数与间隔
  }
  

二、Azure原生服务方案 #

1. Azure Event Grid #

如果你的场景需要大规模、高可靠的事件分发，Azure Event Grid是原生首选。它完全托管，支持事件过滤、自动重试、死信队列，可直接与Azure App Service无缝集成。

• 实现步骤：
  1. 在Azure门户创建Event Grid主题，将目标系统的Webhook配置为订阅端点；
  2. 使用Azure.Messaging.EventGrid NuGet包在C#应用中发送事件：

     using Azure.Messaging.EventGrid;
     
     public async Task PublishEventToGrid(string topicEndpoint, string topicKey, object eventData)
     {
         var client = new EventGridClient(new AzureKeyCredential(topicKey));
         var events = new[]
         {
             new EventGridEvent(
                 subject: "order/123",
                 eventType: "Order.Created",
                 dataVersion: "1.0",
                 data: eventData)
         };
     
         await client.SendEventsAsync(new Uri(topicEndpoint), events);
     }
     

  • 优势：无需自研Webhook的可靠性、重试逻辑，Event Grid自动处理，还支持多订阅者同时分发事件。

2. Azure Logic Apps #

如果需要无代码/低代码实现Webhook推送与复杂路由逻辑，可搭配Azure Logic Apps使用。你可以将App Service的事件作为触发源，在Logic Apps中配置动作推送到目标Webhook，还能添加分支、数据转换、重试等工作流逻辑。

三、方案选择建议 #

• 简单点对点推送、需嵌入应用内部：优先选ASP.NET Core WebHooks SDK或Flurl.Http；
• 大规模事件分发、高可靠性需求：直接用Azure Event Grid，减少自研维护成本；
• 复杂工作流处理（如事件转换、多系统路由）：考虑Azure Logic Apps。

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