ARM模板部署Azure Function App成功，但HTTP触发器未部署

常见原因及修复步骤 #

1. 未配置部署源或部署方式错误 #

如果你的函数代码是本地项目，必须在Bicep中配置部署源，比如用zipDeploy链接到代码包，或者关联GitHub/Azure Repos。

• 示例Bicep zip部署代码片段：

  resource functionApp 'Microsoft.Web/sites@2023-01-01' = {
    name: functionAppName
    location: location
    properties: {
      siteConfig: {
        appSettings: [
          // 务必匹配你的代码运行时，比如dotnet/node/python
          { name: 'FUNCTIONS_WORKER_RUNTIME', value: 'dotnet' }
          { name: 'FUNCTIONS_EXTENSION_VERSION', value: '~4' }
        ]
      }
    }
    // 挂载zip部署扩展
    resource zipDeploy 'extensions@2023-01-01' = {
      name: 'zipdeploy'
      properties: {
        zipFileUri: 'https://<你的存储账户>.blob.core.windows.net/zips/function-code.zip'
      }
    }
  }
  

• 注意：本地代码要先打包成zip，且包内文件结构正确——比如dotnet项目要包含bin/Release/net6.0/publish下的所有文件，Node.js项目要在触发器文件夹里放function.json和业务代码。

2. 运行时配置不匹配 #

检查Bicep里的FUNCTIONS_WORKER_RUNTIME是否和触发器代码语言一致，FUNCTIONS_EXTENSION_VERSION建议用稳定版（比如~4），版本不兼容会导致触发器无法加载。

3. 部署后未触发函数同步 #

有时候部署完代码，Function App不会自动同步触发器，可手动触发或在Bicep里加脚本自动执行：

• Azure CLI命令（部署后执行）：

  az functionapp function sync --name <函数应用名> --resource-group <资源组名>
  

• Bicep中添加自定义脚本扩展自动同步：

  resource syncFunction 'Microsoft.Resources/deploymentScripts@2023-08-01' = {
    name: 'sync-functions'
    location: location
    kind: 'AzureCLI'
    properties: {
      azCliVersion: '2.50.0'
      scriptContent: "az functionapp function sync --name ${functionApp.name} --resource-group ${resourceGroup().name}"
      cleanupPreference: 'OnSuccess'
      retentionInterval: 'PT1H'
    }
  }
  

4. 代码包路径或权限问题 #

• 确保存储zip包的容器有公开读取权限，或者用SAS令牌访问私有存储的包；
• 检查zip包内的文件结构，比如HTTP触发器的function.json必须放在对应文件夹下，不能丢文件。

5. 部署顺序问题 #

确保Function App的依赖资源（存储账户、应用服务计划）先部署完成，再部署代码包。用Bicep的dependsOn明确依赖关系：

resource zipDeploy 'extensions@2023-01-01' = {
  name: 'zipdeploy'
  dependsOn: [
    functionApp
    storageAccount
  ]
  properties: {
    zipFileUri: 'https://<你的存储账户>.blob.core.windows.net/zips/function-code.zip'
  }
}

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