Azure Function blobTrigger无法触发ADLS v2存储的文件夹创建及Blob创建事件

问题根源 #

你遇到的触发失效是ADLS Gen2存储（开启分层命名空间）与普通通用存储账户的路径解析逻辑、Blob Trigger适配要求存在差异，加上原有路径配置只能匹配固定两级子目录导致的，以下是对应解决方案：

解决方案 #

• 修正Blob Trigger路径配置，适配任意层级子目录

  原有配置%bulkUploadContainer%/KP/{name}/{fileName}仅能匹配KP目录下恰好两级子路径的Blob，要匹配任意层级子目录（包括KP根目录下的Blob），将path修改为%bulkUploadContainer%/KP/{**fileName}即可，其中**通配符支持捕获任意深度的子路径，{**fileName}参数会将KP目录后的完整相对路径+文件名传入函数。
  修正后的绑定配置如下：

  "bindings": [{
    "type": "blobTrigger",
    "direction": "in",
    "name": "BlobTriggerBU",
    "path": "%bulkUploadContainer%/KP/{**fileName}",
    "dataType": "binary",
    "connection": "AzureWebJobsStorage"
  }]
  

  注：建议将connection替换为专用的存储连接字符串配置项，而非复用AzureWebJobsDashboard，避免和Functions平台日志逻辑冲突。

• 升级Blob存储扩展版本适配ADLS Gen2

  ADLS Gen2的分层命名空间特性要求使用v5.0.0及以上版本的Microsoft.Azure.WebJobs.Extensions.Storage.Blobs扩展包，若你使用扩展 bundles 管理依赖，需将host.json中的bundles版本升级到v3及以上：

  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[3.*, 4.0.0)"
  }
  

• 补充ADLS Gen2权限配置

  ADLS Gen2的权限校验比普通存储更严格，若你使用AAD身份（含托管身份）访问存储，需为对应身份分配存储Blob数据参与者角色到目标容器；若使用账户密钥访问则无需额外配置。

• 子文件夹创建事件触发适配

  普通存储的目录为虚拟路径，创建目录不会产生事件，ADLS Gen2的目录为真实对象，创建时会产生BlobCreated事件。如果你需要函数在子文件夹创建时也触发：

  • 若使用Blob Trigger，需增加逻辑判断传入的Blob是否为目录（ADLS Gen2目录的元数据中会标注hdi_isfolder=true）
  • 更稳定的方案是替换为Event Grid Trigger，直接订阅存储账户的BlobCreated事件，可自定义过滤规则同时捕获文件和目录创建事件，延迟比Blob Trigger更低。

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