如何在C# Azure Function类静态方法中实现日志记录及BlobServiceClient初始化

你当前用静态字段直接初始化的写法存在核心限制：静态字段初始化阶段Azure Function运行时的ILogger实例还未完成注入，无法直接在初始化方法中拿到可用的日志实例，且静态初始化抛出的异常会直接导致Function App启动失败，错误无法被正常记录到运行时日志中。

推荐采用以下两种方案实现，可根据你使用的Function进程模型选择：

方案1：惰性初始化+调用时日志记录（兼容进程内/孤立进程模型） #

用Lazy实现线程安全的单例延迟初始化，把初始化逻辑延后到第一次Function调用触发时执行，此时可以直接用入参注入的ILogger记录错误：

// 线程安全的懒加载单例，保证只有第一次调用时才执行初始化
private static Lazy<BlobServiceClient> _lazyBlobClient = new Lazy<BlobServiceClient>(GetBlobServiceClient);
// 存储初始化阶段的异常信息
private static Exception _initException = null;
// 建议从环境变量读取存储端点配置，不要硬编码
private static readonly string storageEndpoint = Environment.GetEnvironmentVariable("StorageBlobEndpoint");

private static BlobServiceClient GetBlobServiceClient()
{
    if(string.IsNullOrWhiteSpace(storageEndpoint))
    {
        var argEx = new ArgumentException("存储端点参数不能为空", nameof(storageEndpoint));
        _initException = argEx;
        throw argEx;
    }
    try
    {
        return new BlobServiceClient(new Uri(storageEndpoint), new DefaultAzureCredential(includeInteractiveCredentials: true));
    }
    catch(Exception ex)
    {
        _initException = ex;
        // 直接使用throw保留原始调用栈，不要写throw ex
        throw;
    }
}

[FunctionName("Function1")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req, ILogger log)
{
    // 第一次调用时先校验初始化状态
    if (_initException != null)
    {
        log.LogError(_initException, "BlobServiceClient初始化失败，请检查存储端点配置与托管身份权限");
        return new StatusCodeResult(StatusCodes.Status500InternalServerError);
    }

    // 后续调用直接复用该实例即可
    BlobServiceClient storageBlobClient = _lazyBlobClient.Value;

    // 业务逻辑部分
}

方案2：依赖注入注册单例（仅适用于.NET孤立进程模型） #

如果用的是.NET孤立进程的Function，直接在Program启动类中注册BlobServiceClient为单例，此时可以直接从DI容器拿到ILogger实例记录初始化日志：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        services.AddSingleton(sp =>
        {
            var logger = sp.GetRequiredService<ILogger<Program>>();
            var storageEndpoint = Environment.GetEnvironmentVariable("StorageBlobEndpoint");
            
            if(string.IsNullOrWhiteSpace(storageEndpoint))
            {
                logger.LogError("存储端点环境变量配置为空");
                throw new ArgumentException("存储端点不能为空");
            }

            try
            {
                return new BlobServiceClient(new Uri(storageEndpoint), new DefaultAzureCredential());
            }
            catch (Exception ex)
            {
                logger.LogError(ex, "BlobServiceClient初始化失败");
                throw;
            }
        });
    })
    .Build();

host.Run();

注册后你可以直接在Function的构造函数中注入BlobServiceClient实例使用，无需手动维护单例。

注意事项 #

• 需要提前给Function的托管身份授予对应存储账户的Blob数据访问权限，否则初始化会返回403错误
• 存储端点、权限配置类故障建议配置告警，一旦初始化失败所有相关调用都会不可用

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