Azure Function无法读取Startup类配置的IConfiguration问题求助

问题场景 #

在.NET 8 Isolated模式的Azure Functions项目中，尝试通过自定义Startup类读取host.json中的连接字符串，但运行时注入的IConfiguration始终为null，无法获取配置值。

问题根源 #

1. Isolated模式与FunctionsStartup兼容性问题：FunctionsStartup是为In-Process模式设计的，Isolated模式官方推荐直接通过HostBuilder配置服务和配置，手动构建IConfiguration并注册会和默认配置体系冲突。
2. 构造函数重载导致DI注入失败：Function1存在多个构造函数，依赖注入容器可能选择仅含ILogger的构造函数，导致IConfiguration和HttpClient未被注入。
3. 手动配置的路径问题：Directory.GetCurrentDirectory()在Azure Functions运行时的工作目录并非项目根目录，导致无法正确读取host.json。

修复步骤 #

1. 移除自定义Startup类 #

Isolated模式无需使用FunctionsStartup，直接在Program.cs中配置。删除Startup.cs文件，同时移除项目文件中关于Startup.cs的编译配置。

2. 修改Program.cs，正确加载host.json #

在HostBuilder中添加host.json作为配置源，合并到默认配置体系：

using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

var host = new HostBuilder()
    .ConfigureAppConfiguration((context, config) =>
    {
        // 添加host.json作为配置源
        config.AddJsonFile("host.json", optional: true, reloadOnChange: true);
        // 保留默认配置源（local.settings.json、环境变量等）
        config.AddEnvironmentVariables();
    })
    .ConfigureFunctionsWebApplication()
    .ConfigureServices(services =>
    {
        services.AddApplicationInsightsTelemetryWorkerService();
        services.ConfigureFunctionsApplicationInsights();
        // 注册HttpClient
        services.AddHttpClient();
    })
    .Build();

host.Run();

3. 修正Function1的构造函数 #

移除多余构造函数，确保只有一个包含所有依赖的构造函数，让DI容器正确注入服务：

using FirstFunction.dto;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.Logging;
using Newtonsoft.Json;
using System.Globalization;
using System.Text;
using Azure.Storage.Queues;
using Azure.Storage.Queues.Models;
using Microsoft.Extensions.Configuration;
using System.Reflection;

namespace FirstFunction
{
    public class Function1
    {
        private readonly ILogger<Function1> _logger;
        private readonly IConfiguration _configuration;
        private readonly HttpClient _httpClient;

        // 仅保留该构造函数，确保DI注入所有依赖
        public Function1(ILogger<Function1> logger, IConfiguration configuration, HttpClient httpClient)
        {
            _logger = logger;
            _configuration = configuration;
            _httpClient = httpClient;
        }

        [Function("Function1")]
        public async Task<IActionResult> Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequest req)
        {
            string requestBody = string.Empty;
            try
            {
                requestBody = await new StreamReader(req.Body).ReadToEndAsync();
            }
            catch (Exception ex)
            {
                _logger.LogError($"Error reading request body: {ex.Message}");
                return new StatusCodeResult(StatusCodes.Status500InternalServerError);
            }

            string myConnectionString = _configuration["ConnectionStrings:QUEUE_CONNECTION_STRING"];
            // 后续业务逻辑...

            return new OkObjectResult("Data was sent to backend");
        }
    }
}

4. 确保host.json结构正确 #

检查host.json中是否包含正确的连接字符串节点：

{
  "version": "2.0",
  "ConnectionStrings": {
    "QUEUE_CONNECTION_STRING": "your-actual-queue-connection-string"
  },
  "logging": {
    "applicationInsights": {
      "samplingSettings": {
        "isEnabled": true,
        "excludedTypes": "Request"
      },
      "enableLiveMetricsFilters": true
    }
  }
}

5. 验证项目文件配置 #

确保host.json被设置为复制到输出目录（你的项目已配置，可跳过）：

<None Update="host.json">
  <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</None>

额外说明 #

• Isolated模式下，Azure Functions默认加载local.settings.json（本地开发）、环境变量（部署后），添加host.json后配置会自动合并，可通过IConfiguration统一访问。
• 避免手动构建IConfiguration并注册单例，这会覆盖默认配置实例，导致注入结果不符合预期。

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