NET6 Azure Functions(Runtime4.x)host.json配置未生效求助

基于.NET 6构建的Azure Functions项目，运行时版本为4.x（使用进程内模型），配置了host.json如下：

{
  "version": "2.0",
  "functions": [ "MyFunction" ],
  "logging": {
    "applicationInsights": {
      "samplingSettings": {
        "isEnabled": true
      }
    }
  },
  "extensions": {
    "queues": {
      "batchSize": 1,
      "newBatchThreshold": 0,
      "maxDequeueCount": 5,
      "visibilityTimeout": "00:01:00"
    }
  }
}

本地调试时出现两个配置失效问题：

1. 所有函数均启动运行，未按配置仅加载MyFunction
2. 队列触发函数抛出异常后，消息需10分钟才重新可见，与配置的1分钟不符

已排查：

• bin\Debug\net6.0目录下存在正确的host.json文件
• 新建同配置项目复现相同问题
• 未使用隔离工作进程模型
• 尝试在Startup.cs中配置visibilityTimeout无效果

问题1：指定仅运行单个函数不生效 #

本地调试时，Azure Functions CLI默认会加载所有函数，host.json中的functions数组过滤逻辑不会自动生效，需通过以下方式启用：

• 命令行参数启动：在终端执行启动命令时添加指定参数

  func start --functions MyFunction
  

• 配置环境变量：添加环境变量AzureWebJobsFunctions=MyFunction，可在launchSettings.json中配置（本地调试优先读取）：

  {
    "profiles": {
      "YourFunctionProject": {
        "commandName": "Project",
        "environmentVariables": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "dotnet",
          "AzureWebJobsFunctions": "MyFunction"
        }
      }
    }
  }
  

问题2：队列消息可见性超时配置不生效 #

按以下步骤排查修复：

1. 检查函数代码是否硬编码覆盖配置
   若QueueTrigger属性中指定了VisibilityTimeout参数，会优先覆盖host.json配置，需移除该硬编码：

   // 错误示例（硬编码会覆盖host.json）
   [QueueTrigger("my-queue", VisibilityTimeout = "00:10:00")]
   // 正确写法（使用host.json配置）
   [QueueTrigger("my-queue")]
   

2. 确认Azure Functions CLI版本
   执行func --version确认CLI版本为4.x，若版本过低需升级，版本不匹配会导致配置读取异常：

   func --version
   

3. 修正Startup.cs中的配置方式
   若通过Startup.cs配置队列选项，需引用正确的QueueOptions类并注入：

   using Microsoft.Azure.Functions.Extensions.DependencyInjection;
   using Microsoft.Extensions.DependencyInjection;
   using Microsoft.Azure.WebJobs.Host.Queues;
   using System;
   
   [assembly: FunctionsStartup(typeof(YourNamespace.Startup))]
   namespace YourNamespace
   {
       public class Startup : FunctionsStartup
       {
           public override void Configure(IFunctionsHostBuilder builder)
           {
               builder.Services.Configure<QueueOptions>(options =>
               {
                   options.VisibilityTimeout = TimeSpan.FromMinutes(1);
                   options.BatchSize = 1;
                   options.NewBatchThreshold = 0;
                   options.MaxDequeueCount = 5;
               });
           }
       }
   }
   

4. 确认host.json复制属性
   右键host.json文件 → 属性，设置“复制到输出目录”为始终复制，确保编译时文件正确同步到输出目录。

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