Azure Python函数Zip部署后Blob触发器无法触发问题排查

开发者阿泽

2026-7-24

问题：Terraform部署Azure Linux消费计划Function App后Blob触发器失效

我用Terraform部署Azure Linux Function App（消费计划），函数包是包含3个.py脚本、__init__.py和function.json的zip文件。代码部署成功，但Blob触发器（特定MP4文件上传到容器时触发）无法工作。

用Azure Function Core Tools部署时，触发器正常工作（日志流显示持续轮询容器）；但用CLI或Terraform上传代码时，触发器完全没反应。

我的Terraform azurerm_linux_function_app配置：

resource "azurerm_linux_function_app" "blurring_fn_app" {
  name                        = "blurring-app-new4"
  location                    = var.location
  resource_group_name         = var.resource_group
  storage_account_name        = var.storage_account
  storage_account_access_key  = data.azurerm_key_vault_secret.sensestgaccountkey.value
  service_plan_id             = azurerm_service_plan.blurring_app_service_plan.id
  functions_extension_version = "~4"
  app_settings = {
    "APPINSIGHTS_INSTRUMENTATIONKEY" = "${data.azurerm_key_vault_secret.appinsightskey.value}"
    "AzureWebJobsStorage"            = "${data.azurerm_key_vault_secret.azure_web_jobs_storage.value}" 
    "ENABLE_ORYX_BUILD"              = true
    "SCM_DO_BUILD_DURING_DEPLOYMENT" = true
  }
  site_config {
    application_insights_key               = data.azurerm_key_vault_secret.appinsightskey.value
    application_insights_connection_string = data.azurerm_key_vault_secret.appinsightsconnstr.value
    application_stack {
      python_version = "3.9"
    }
  }
}

已尝试的操作：

使用func CLI部署，代码上传成功，但触发器无法触发
配置WEBSITE_RUN_FROM_PACKAGE指向存储Blob中的zip包URL（Linux消费计划要求用URL方式），代码上传成功但触发器失效
在azurerm_linux_function_app中使用zip_deploy_file参数指向本地zip，问题依旧
上述三种部署方式后，都手动调用了触发器同步接口，无效

function.json内容：

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "name": "myblob",
      "type": "blobTrigger",
      "direction": "in",
      "path": "blobcontainername/{name}.mp4",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

如何确保Terraform部署后Blob触发器正常工作？

解决方案

1. 检查`AzureWebJobsStorage`的有效性

确保AzureWebJobsStorage是完整的存储连接字符串（不是仅访问密钥），且对应的存储账户是通用v2类型（Blob触发器不支持v1存储）。同时确认存储账户对目标容器有Blob数据参与者或更高权限，权限不足会导致触发器无法轮询容器。

2. 修正部署模式的配置冲突

Linux消费计划下，ENABLE_ORYX_BUILD和WEBSITE_RUN_FROM_PACKAGE不能同时启用：

若使用WEBSITE_RUN_FROM_PACKAGE，必须禁用构建相关配置，因为该模式直接运行打包好的代码，无需构建步骤。调整app_settings如下：

app_settings = {
  "APPINSIGHTS_INSTRUMENTATIONKEY" = data.azurerm_key_vault_secret.appinsightskey.value
  "AzureWebJobsStorage"            = data.azurerm_key_vault_secret.azure_web_jobs_storage.value
  "WEBSITE_RUN_FROM_PACKAGE"       = azurerm_storage_blob.storage_blob_function.url
  "ENABLE_ORYX_BUILD"              = false
  "SCM_DO_BUILD_DURING_DEPLOYMENT" = false
}

3. 确保触发器同步时机正确

Terraform部署完成后，函数App可能未完全启动，此时同步触发器会无效。可以在Terraform中添加null_resource，延迟执行同步操作：

resource "null_resource" "sync_function_triggers" {
  depends_on = [azurerm_linux_function_app.blurring_fn_app]

  provisioner "local-exec" {
    command = <<EOT
      az rest --method POST \
        --uri "/subscriptions/${var.subscription_id}/resourceGroups/${var.resource_group}/providers/Microsoft.Web/sites/${azurerm_linux_function_app.blurring_fn_app.name}/syncfunctiontriggers?api-version=2023-01-01"
    EOT
  }
}

4. 检查函数包目录结构

确保zip包根目录直接包含__init__.py、function.json和其他.py脚本，不要嵌套在子文件夹中。目录结构错误会导致函数无法被识别，触发器自然不会注册。

5. 验证触发器路径匹配

确认function.json中path字段的容器名称blobcontainername与实际存储容器名称完全一致（区分大小写），且上传的文件确实是.mp4后缀，没有拼写错误。

6. 检查函数扩展版本兼容性

Functions v4对Python 3.9的支持没问题，但要确保函数App的functions_extension_version设置为~4，同时避免混合使用v3和v4的依赖包。

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

Azure Python函数Zip部署后Blob触发器无法触发问题排查

1. 检查AzureWebJobsStorage的有效性 #

2. 修正部署模式的配置冲突 #

3. 确保触发器同步时机正确 #

4. 检查函数包目录结构 #

5. 验证触发器路径匹配 #