Azure Bicep创建Event Grid订阅用Function资源报错，求排查

我尝试部署带有Event Grid触发器的FunctionApp，目标是当存储账户内创建Blob时触发函数。目前已成功创建FunctionApp、存储账户以及Event Grid主题，但在创建用于Event Grid订阅的Function资源时遇到问题，报错提示运行时不可用。

相关代码文件 #

modules/FunctionApp/Function.bicep #

我原本想创建一个占位Function用于后续Event Grid订阅，后续计划通过VSCode的「Deploy to Function App...」部署代码，模板如下：

@allowed([
  'http'
  'eventgrid'
])
param triggerType string = 'http'

param functionAppName string

resource functionApp 'Microsoft.Web/sites@2022-09-01' existing = {
  name: functionAppName
}

var functionName = (triggerType == 'eventgrid') ? 'EventGridTrigger' 
: 'HttpTrigger'

resource function2inModule 'Microsoft.Web/sites/functions@2022-09-01' = if(triggerType == 'eventgrid') {
  parent: functionApp
  name: functionName
  properties: {
    language: 'python'
    isDisabled: false
  }
}

main.bicep 相关片段 #

// storage account for data
module storageAccount4data 'modules/Storage/StorageAccount.bicep' = {
  name: storageAccount4dataName
  params: {
    location: location
    storageAccountName: storageAccount4dataName
  }
}

// blob service
module blobServices 'modules/Storage/BlobService.bicep' = {
  name: 'default'
  params: {
    blobServiceName: 'default'
    storageAccountName: storageAccount4data.outputs.dtls.name
  }
}

// container
module container 'modules/Storage/Container.bicep' = {
  name: containerName
  params: {
    storageAccountName: storageAccount4data.outputs.dtls.name
    blobServiceName: blobServices.outputs.name
    containerName: containerName
  }
}

var functionApp2Name = '${funcAppNamePrefix}-2-preProcAndWriteToDB'

module functionApp2 'modules/FunctionApp/FunctionApp.bicep' = {
  name: functionApp2Name
  params: {
    location: location
    functionAppName: functionApp2Name
    functionStorageAccountName: storageAccounts4func[1].outputs.dtls.name
  }
}

// event grid resources
resource systemtopic 'Microsoft.EventGrid/systemTopics@2023-06-01-preview' = {
  name: eventGridTopicName
  location: location
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    source: storageAccount4data.outputs.dtls.id
    topicType: 'Microsoft.Storage.StorageAccounts'
  }
}

// 出现问题的模块
module function2 'modules/FunctionApp/Function.bicep' = {
  name: 'function2Name'
  params: {
    functionAppName: functionApp2.outputs.functionAppName
    triggerType: 'eventgrid'
  }
}

// 后续计划创建的Event Grid订阅
// resource eventsubscription 'Microsoft.EventGrid/systemTopics/eventSubscriptions@2023-06-01-preview' = {
//   parent: systemtopic
//   name: functionApp2.name
//   properties: {
//     destination: {
//       properties: {
//         resourceId: '${functionApp2.outputs.functionAppId}/functions/EventGridTrigger'
//         maxEventsPerBatch: 1
//         preferredBatchSizeInKilobytes: 64
//       }
//       endpointType: 'AzureFunction'
//     }
//     filter: {
//       subjectBeginsWith: '/blobServices/default/containers/${containerName}/blobs/'
//       subjectEndsWith: '.json'
//       includedEventTypes: [
//         'Microsoft.Storage.BlobCreated'
//       ]
//       enableAdvancedFilteringOnArrays: true
//     }
//     labels: []
//     eventDeliverySchema: 'EventGridSchema'
//     retryPolicy: {
//       maxDeliveryAttempts: 30
//       eventTimeToLiveInMinutes: 1440
//     }
//   }
// }

错误信息 #

Encountered an error (ServiceUnavailable) from host runtime.
(Target: /subscriptions/{}/resourceGroups/{}/providers/Microsoft.Resources/deployments/function2Name)

问题排查与解决方案 #

1. Function资源定义不完整 #

当前的Function资源仅指定了language和isDisabled，缺少触发器绑定配置和必要元数据，导致Function App运行时无法识别该资源，抛出ServiceUnavailable错误。即使是占位Function，也需要基础的触发器配置让平台正确识别。

修改modules/FunctionApp/Function.bicep中的function2inModule资源：

resource function2inModule 'Microsoft.Web/sites/functions@2022-09-01' = if(triggerType == 'eventgrid') {
  parent: functionApp
  name: functionName
  properties: {
    language: 'python'
    isDisabled: false
    config: {
      bindings: [
        {
          type: 'eventGridTrigger'
          direction: 'in'
          name: 'eventGridEvent'
        }
      ]
    }
    files: {} // 空文件对象，后续部署代码会自动覆盖
  }
}

2. 模块部署依赖与命名问题 #

• 确保模块部署名称唯一：当前function2模块的名称function2Name过于通用，建议改为带前缀的唯一名称，比如deploy-${functionApp2Name}-eventgrid-function，避免与其他部署资源冲突。
• 添加显式依赖：确保FunctionApp完全部署就绪后再创建Function资源，在main.bicep的function2模块中添加dependsOn：

  module function2 'modules/FunctionApp/Function.bicep' = {
    name: 'deploy-${functionApp2Name}-eventgrid-function'
    params: {
      functionAppName: functionApp2.outputs.functionAppName
      triggerType: 'eventgrid'
    }
    dependsOn: [
      functionApp2
    ]
  }
  

3. 简化流程：跳过占位Function #

其实无需提前创建占位Function，更可靠的流程是：

1. 先部署FunctionApp、存储账户和Event Grid系统主题
2. 通过VSCode将函数代码部署到FunctionApp
3. 最后创建Event Grid订阅（此时函数资源已由平台自动注册）

这种方式避免了手动创建占位资源的兼容性问题，直接利用代码部署后自动生成的函数资源ID即可完成订阅配置。

内容的提问来源于stack exchange，提问作者average.everyman