Hangfire未使用配置的Logger记录异常，ASP.NET Core 2.0+Serilog技术问询

我之前也碰到过一模一样的情况——明明照着官方文档说的，Hangfire 1.3+会自动检测Serilog这类日志库，但在ASP.NET Core 2.0环境里就是不生效。后来才搞明白，Core环境的依赖注入机制和传统框架不一样，自动检测有时候没那么靠谱，得手动帮Hangfire“绑定”到你配置好的Serilog上。下面是我亲测有效的解决步骤：

1. 确认安装了正确的NuGet包 #

首先得确保你装了适配ASP.NET Core的Hangfire包、Serilog包，以及两者的集成包：

# NuGet包管理器控制台
Install-Package Hangfire.AspNetCore
Install-Package Serilog.AspNetCore
Install-Package Hangfire.Serilog

# 或者用.NET CLI
dotnet add package Hangfire.AspNetCore
dotnet add package Serilog.AspNetCore
dotnet add package Hangfire.Serilog

2. 显式配置Hangfire使用Serilog #

在Startup.cs的ConfigureServices方法里，配置Hangfire的时候一定要加上UseSerilog()，强制它使用你已经配置好的Serilog实例，别依赖自动检测：

public void ConfigureServices(IServiceCollection services)
{
    // 其他服务配置（比如MVC、数据库连接等）...

    services.AddHangfire(config =>
    {
        // 先配置你的Hangfire存储，比如SQL Server
        config.UseSqlServerStorage(Configuration.GetConnectionString("HangfireConnection"));
        // 关键步骤：显式指定使用Serilog
        config.UseSerilog();
    });

    // 注册Hangfire服务器
    services.AddHangfireServer();
}

3. 确保Serilog在应用启动时正确初始化 #

检查你的Program.cs，确认Serilog已经被正确初始化，并且ASP.NET Core整个框架都在使用Serilog：

public static void Main(string[] args)
{
    // 初始化Serilog，可根据需求配置输出目标（控制台、文件、ELK等）
    Log.Logger = new LoggerConfiguration()
        .ReadFrom.Configuration(Configuration)
        .Enrich.FromLogContext()
        .WriteTo.Console()
        .WriteTo.File("logs/hangfire-logs-.txt", rollingInterval: RollingInterval.Day)
        .CreateLogger();

    try
    {
        Log.Information("启动Web主机");
        CreateWebHostBuilder(args).Build().Run();
    }
    catch (Exception ex)
    {
        Log.Fatal(ex, "Web主机意外终止");
    }
    finally
    {
        Log.CloseAndFlush();
    }
}

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .UseSerilog() // 让ASP.NET Core整体框架使用Serilog
        .UseStartup<Startup>();

4. 测试异常日志是否生效 #

写一个会抛出异常的测试任务，验证Hangfire的异常是否能被Serilog捕获：

public class TestHangfireJob
{
    public void ThrowTestException()
    {
        throw new InvalidOperationException("这是一个测试Hangfire异常日志的错误");
    }
}

// 在某个地方调度这个任务（比如控制器方法里）
BackgroundJob.Enqueue<TestHangfireJob>(job => job.ThrowTestException());

执行任务后，去你配置的Serilog输出目标（比如日志文件或控制台）里看看，应该能看到这个异常的详细日志了。

额外注意事项 #

• 确保你的Hangfire版本是1.3.0及以上（ASP.NET Core 2.0对应的Hangfire稳定版肯定满足，尽量用最新的稳定版）；
• 不要同时给Hangfire配置多个日志提供器，避免冲突；
• 显式调用UseSerilog()会直接使用全局的Log.Logger实例，这比依赖自动检测要稳定得多。

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