Azure函数无法被Blob存储触发器触发，求故障排查思路

问题背景 #

因工作需求从AWS转用Azure，需将Azure存储账户的日志同步到AWS S3（合规要求），参考AWS S3触发Lambda的逻辑，使用Serverless Framework部署Blob触发的Azure函数，但手动向目标容器添加文件时函数始终未被触发。

已部署配置 #

serverless.yml 配置 #

---
service: export-logs-to-aws-s3

provider:
  name: azure
  location: East US
  runtime: nodejs18
  environment:
    AzureWebJobsREDACTEDStorage: "DefaultEndpointsProtocol=https;AccountName=REDACTED;AccountKey=REDACTED;EndpointSuffix=core.windows.net"

plugins:
  - serverless-azure-functions

package:
  exclude:
    - node_modules/**
    - .gitignore
    - package.json
    - .git/**

functions:
  exportToS3:
    handler: handler.exportToS3
    events:
      - blob: true
        name: item
        path: "insights-activity-logs/{name}"
        connection: REDACTEDStorage

生成的 function.json #

{
  "disabled": false,
  "bindings": [
    {
      "type": "blobTrigger",
      "direction": "in",
      "name": "item",
      "path": "insights-activity-logs/{name}",
      "connection": "REDACTEDStorage"
    }
  ],
  "entryPoint": "exportToS3",
  "scriptFile": "../handler.js"
}

已完成操作 #

已为Azure Function App身份在目标存储账户分配Storage Blob Data Owner和Storage Queue Data Contributor角色。

排查方向与修复建议 #

• 升级函数扩展版本：当前使用的FUNCTIONS_EXTENSION_VERSION为~3，而最新文档多基于v5版本，Blob触发器在两个版本间存在配置和行为差异。可在serverless.yml的provider.environment中添加FUNCTIONS_EXTENSION_VERSION: '~5'，或直接在Azure门户的函数应用「配置」-「应用设置」中修改该参数，部署后重启函数应用。
• 验证连接字符串正确性：确认AzureWebJobsREDACTEDStorage环境变量中的存储账户名、密钥无误，且对应账户为目标日志存储账户。Azure会自动识别AzureWebJobs前缀的连接字符串，触发器配置中的connection字段无需重复前缀，当前配置逻辑正确，但需核对实际值。
• 检查Blob路径匹配规则：
  • 确认存储容器insights-activity-logs名称为小写（Azure存储容器名强制小写，大小写不匹配会导致触发器无法识别）；
  • 若日志文件存放在容器子目录中，需调整path为insights-activity-logs/{subfolder}/{name}格式，确保匹配文件实际路径。
• 确认触发器轮询机制正常：Blob触发器依赖存储账户中的azure-webjobs-hosts队列实现轮询，首次部署后可能需要等待3-5分钟才会启动轮询。可手动检查目标存储账户的队列列表，确认该队列已创建（若未创建，需验证Function App的队列权限是否生效）。
• 排查函数运行状态与日志：
  • 在Azure门户确认函数应用处于「运行中」状态，未被停止或缩放；
  • 进入函数应用「监控」-「日志」，查看是否有触发器初始化失败、权限错误或连接异常的日志；也可使用Azure CLI命令az functionapp log tail --name <function-app-name> --resource-group <resource-group-name>实时查看运行日志。
• 更新Serverless插件版本：旧版serverless-azure-functions插件可能对新版函数扩展支持不足，运行npm update serverless-azure-functions更新插件后重新部署。
• 测试小文件触发：使用Azure存储浏览器上传1MB以内的小文件测试，避免大文件触发延迟或被过滤的情况。

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