升级Azure Function至.NET 8独立模式导致EventGrid触发器失效

1. 核对触发器注解与依赖包 #

独立工作者模式下的Event Grid触发器注解和进程内模式存在差异，需确保使用正确的命名空间与依赖：

• 确认项目引用Microsoft.Azure.Functions.Worker.Extensions.EventGrid NuGet包，版本需适配.NET 8
• 触发器代码需使用Microsoft.Azure.Functions.Worker命名空间下的[EventGridTrigger]，示例代码如下：

  using Microsoft.Azure.Functions.Worker;
  using Microsoft.Azure.Functions.Worker.Extensions.EventGrid;
  using Azure.Messaging.EventGrid;
  
  public class BlobEventHandler
  {
      [Function("BlobEventProcessor")]
      public void ProcessBlobEvent([EventGridTrigger] EventGridEvent eventGridEvent)
      {
          // 事件处理逻辑
      }
  }
  

2. 检查host.json配置 #

独立工作者模式的host.json结构与旧版不同，需确保Event Grid扩展配置正确：

{
  "version": "2.0",
  "extensions": {
    "eventGrid": {
      "maxBatchSize": 10,
      "prefetchCount": 5,
      "batchProcessingWaitTime": "00:00:01"
    }
  }
}

若缺失extensions.eventGrid节点，可能导致触发器无法正常注册。

3. 验证Event Grid订阅配置 #

• 确认订阅的端点URL指向当前Function的触发地址，避免因部署、Function名称变更导致地址失效
• 检查订阅的死信存储：若存在死信事件，可通过死信内容定位具体错误（如权限拒绝、事件格式不兼容）
• 核对订阅的事件类型：确保勾选了需要监听的Blob事件（如Microsoft.Storage.BlobCreated）

4. 排查权限与身份验证问题 #

• 若Function启用了系统分配托管身份，需为Event Grid服务主体分配访问Function的权限：在Function的IAM设置中添加EventGrid EventSubscription Contributor角色
• 若使用密钥验证，确认Event Grid订阅中配置的Function访问密钥正确，未过期或被修改

5. 查看日志与监控数据 #

• 打开Azure Portal中Function的日志流，检查是否有Event Grid请求到达但处理失败的记录（如反序列化错误、未捕获异常）
• 查看Event Grid的监控指标：重点关注Delivery Failed Events指标，判断事件是未发送还是未被Function接收

6. 确认Blob存储的Event Grid启用状态 #

检查Blob存储账户的事件设置，确认已启用Event Grid事件发布功能，未被意外关闭

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