Azure Function v2迁移后如何以单例方式加载配置？

Azure Functions v2及以上版本原生支持依赖注入，这是处理配置和单例服务（比如你的MyCosmosDbClient）的最优方式——比手动写Init方法更符合.NET现代开发规范，还能让宿主自动管理服务生命周期，避免手动处理线程安全和初始化逻辑。

步骤1：添加必要的NuGet包 #

首先安装Functions扩展的DI包：

Install-Package Microsoft.Azure.Functions.Extensions

如果使用官方Cosmos DB客户端，还需安装对应依赖包：

Install-Package Microsoft.Azure.Cosmos

步骤2：创建Startup类注册服务 #

创建一个继承自FunctionsStartup的类，用来配置DI容器。在这里你可以直接访问宿主的配置系统，完全不需要依赖ExecutionContext——因为宿主已经帮你加载了local.settings.json和环境变量的配置：

using Microsoft.Azure.Functions.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;

[assembly: FunctionsStartup(typeof(YourFunctionAppNamespace.Startup))]
namespace YourFunctionAppNamespace
{
    public class Startup : FunctionsStartup
    {
        public override void Configure(IFunctionsHostBuilder builder)
        {
            // 直接从宿主配置中读取Cosmos DB参数
            string cosmosUri = builder.Configuration["CosmosDb.Uri"];
            string cosmosKey = builder.Configuration["CosmosDb.Key"];
            
            // 注册单例的MyCosmosDbClient
            builder.Services.AddSingleton<MyCosmosDbClient>(sp => 
                new MyCosmosDbClient(cosmosUri, cosmosKey));
        }
    }
}

步骤3：在函数中注入客户端 #

现在你可以通过构造函数直接注入MyCosmosDbClient，不需要手动处理任何初始化逻辑：

public class YourFunction
{
    private readonly MyCosmosDbClient _cosmosClient;

    // 构造函数注入，由DI容器自动提供实例
    public YourFunction(MyCosmosDbClient cosmosClient)
    {
        _cosmosClient = cosmosClient;
    }

    [FunctionName("YourFunctionName")]
    public async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "get", Route = null)] HttpRequest req,
        ILogger log)
    {
        // 直接使用注入的_cosmosClient
        log.LogInformation("Using Cosmos DB client to perform operations");
        // 你的业务逻辑...
        return new OkResult();
    }
}

备选方案：手动初始化（Lazy+Init方法） #

如果因为某些限制无法使用DI，你可以用Lazy<T>结合Init方法实现延迟初始化，确保配置只加载一次，同时保证线程安全：

private static Lazy<IConfigurationRoot> _lazyConfig = new Lazy<IConfigurationRoot>();
private static readonly Lazy<MyCosmosDbClient> _lazyCosmosClient = new Lazy<MyCosmosDbClient>(() =>
    new MyCosmosDbClient(_lazyConfig.Value["CosmosDb.Uri"], /* 其他参数 */));

private static void InitConfig(ExecutionContext context)
{
    if (!_lazyConfig.IsValueCreated)
    {
        var config = new ConfigurationBuilder()
            .SetBasePath(context.FunctionAppDirectory)
            .AddJsonFile("local.settings.json", optional: true, reloadOnChange: true)
            .AddEnvironmentVariables()
            .Build();
        
        // 用Interlocked保证线程安全地替换Lazy实例
        Interlocked.Exchange(ref _lazyConfig, new Lazy<IConfigurationRoot>(() => config));
    }
}

[FunctionName("YourFunctionName")]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", Route = null)] HttpRequest req,
    ExecutionContext context,
    ILogger log)
{
    // 仅第一次调用时初始化配置
    InitConfig(context);
    
    // 获取单例客户端
    var cosmosClient = _lazyCosmosClient.Value;
    // 业务逻辑...
    return new OkResult();
}

不过要注意，这种方式需要自己处理线程安全，而且在函数缩放时，每个函数实例都会有独立的静态变量，不如DI方式由宿主统一管理来得可靠。

总结来说，依赖注入是Azure Functions v2+的推荐方案，它简化了配置和服务管理，让代码更易测试和维护。

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