如何让ServiceBusTrigger Azure函数停止监听主题订阅？

部署环境的正确配置方法 #

本地调试时用local.settings.json的AzureWebJobs.MyFunction.Disabled=true仅适用于本地，部署到Azure后需要通过应用设置来配置禁用：

• 登录Azure门户，找到目标函数应用，进入「配置」>「应用设置」
• 添加新设置：
  • 名称：AzureWebJobs.MyFunction.Disabled
  • 值：true
• 保存后函数应用会自动重启，该ServiceBusTrigger函数将停止监听主题订阅

如果用ARM模板或Bicep做基础设施部署，可在模板中直接定义该应用设置：

// ARM模板示例片段
"resources": [
  {
    "type": "Microsoft.Web/sites/config",
    "name": "[concat(parameters('functionAppName'), '/appsettings')]",
    "apiVersion": "2021-03-01",
    "properties": {
      "AzureWebJobs.MyFunction.Disabled": "true",
      // 其他应用设置...
    }
  }
]

为什么appSettings.json配置无效 #

Azure函数部署后，默认不会加载项目中的appSettings.json作为应用设置——该文件仅用于本地开发调试。部署后的函数应用优先读取Azure门户配置的应用设置，因此直接修改appSettings.json并部署无法生效。

无效方案说明 #

• 仅在函数体加if判断：只会终止消息处理逻辑，但触发器仍会持续拉取主题消息，要么自动完成消息（默认行为），要么导致消息被反复锁存（AutoComplete=false时），无法停止监听。
• 设置AutoCompleteMessages = false：仅改变消息的完成机制，完全无法阻止触发器拉取消息，反而可能引发消息重复投递问题。

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