Azure Function中如何在无参方法中使用ILogger记录日志

一、构造注入的正确实现步骤 #

Azure Function的依赖注入有固定配置要求，必须确保你的日志业务类由DI容器管理，才能让构造注入的ILogger生效：

1. 添加Startup.cs配置DI容器（如果没有的话）

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

[assembly: FunctionsStartup(typeof(YourProjectNamespace.Startup))]
namespace YourProjectNamespace
{
    public class Startup : FunctionsStartup
    {
        public override void Configure(IFunctionsHostBuilder builder)
        {
            // 将你的日志业务类注册为Scoped（和Function实例生命周期一致）
            builder.Services.AddScoped<LogOperationService>();
        }
    }
}

2. 编写包含无参日志方法的业务类，通过构造函数注入泛型ILogger

public class LogOperationService
{
    private readonly ILogger<LogOperationService> _logger;

    // 必须由DI容器实例化该类，禁止手动new
    public LogOperationService(ILogger<LogOperationService> logger)
    {
        _logger = logger;
    }

    public void LogTask1()
    {
        _logger.LogInformation("任务1执行完成，记录信息日志");
    }

    public void LogTask2()
    {
        _logger.LogWarning("任务2触发阈值，记录警告日志");
    }

    // 剩余3个无参日志方法依此类推
}

3. 在Function入口类中注入业务类实例，调用无参日志方法

public class MainFunction
{
    private readonly LogOperationService _logService;

    // 构造注入业务类，而非手动实例化
    public MainFunction(LogOperationService logService)
    {
        _logService = logService;
    }

    [FunctionName("MainFunctionEntry")]
    public async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "get", Route = null)] HttpRequest req)
    {
        // 无参调用日志方法
        _logService.LogTask1();
        _logService.LogTask2();
        // 其他业务逻辑...
        return new OkObjectResult("执行完成");
    }
}

二、排查日志不输出的常见问题 #

• 日志级别配置过低：检查host.json中是否开启了对应级别的日志，比如用LogInformation但只配置了Warning及以上：

{
  "logging": {
    "logLevel": {
      "YourProjectNamespace.LogOperationService": "Information",
      "Default": "Information"
    }
  }
}

• 手动实例化业务类：如果代码中出现new LogOperationService()，DI容器不会注入ILogger，必须通过构造注入获取实例。
• 泛型ILogger使用错误：避免直接注入非泛型ILogger，使用ILogger<T>绑定当前类，否则会丢失日志上下文，导致日志无法正确输出。

三、备选方案：静态Logger实例（适合简单场景） #

如果不想依赖DI容器，可通过LoggerFactory初始化静态Logger：

public static class StaticLogService
{
    private static ILogger _logger;

    // 在Function启动时执行一次初始化
    public static void Initialize(ILoggerFactory loggerFactory)
    {
        _logger = loggerFactory.CreateLogger<StaticLogService>();
    }

    public static void LogTask3()
    {
        _logger.LogError("任务3执行失败，记录错误日志");
    }
}

然后在Startup的Configure方法中完成初始化：

public override void Configure(IFunctionsHostBuilder builder)
{
    var loggerFactory = builder.Services.BuildServiceProvider().GetService<ILoggerFactory>();
    StaticLogService.Initialize(loggerFactory);
}

之后即可无参调用StaticLogService.LogTask3()。

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