如何从ASP.NET Core后台服务读取状态到Minimal API？

方法一：直接让后台服务暴露状态并注入实例 #

由于AddHostedService<MyService>()会将服务注册为单例的IHostedService，我们可以额外将MyService自身注册为单例服务，让Minimal API直接注入并读取状态。同时要注意线程安全，避免多线程访问时的可见性问题。

1. 改造MyService，添加线程安全的状态属性

public class MyService : BackgroundService
{
    // 使用volatile确保多线程下的变量可见性
    private volatile bool _isRunning;
    // 对外暴露只读状态
    public bool IsRunning => _isRunning;

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        _isRunning = true;
        try
        {
            while (!stoppingToken.IsCancellationRequested)
            {
                // 你的后台任务逻辑
                await Task.Delay(1000, stoppingToken);
            }
        }
        finally
        {
            _isRunning = false;
        }
    }
}

2. 在Program.cs中完成服务注册与API端点定义

var builder = WebApplication.CreateBuilder(args);

// 注册托管服务，同时将MyService注册为单例以便直接注入
builder.Services.AddHostedService<MyService>();
builder.Services.AddSingleton<MyService>(sp => 
    sp.GetRequiredService<IEnumerable<IHostedService>>()
        .OfType<MyService>()
        .First());

var app = builder.Build();

// Minimal API端点：读取服务状态
app.MapGet("/service-status", (MyService service) => 
{
    return Results.Ok(new { IsRunning = service.IsRunning });
});

app.Run();

方法二：使用共享状态容器（解耦方案） #

如果不想让API直接依赖MyService，可以定义一个独立的单例状态容器，让后台服务和API通过容器间接交互，更符合依赖倒置原则。

1. 定义共享状态容器

public class ServiceStatus
{
    private volatile bool _isRunning;
    public bool IsRunning => _isRunning;

    // 仅允许内部/授权方修改状态
    public void SetRunningStatus(bool value)
    {
        _isRunning = value;
    }
}

2. 改造MyService注入状态容器

public class MyService : BackgroundService
{
    private readonly ServiceStatus _statusContainer;

    public MyService(ServiceStatus statusContainer)
    {
        _statusContainer = statusContainer;
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        _statusContainer.SetRunningStatus(true);
        try
        {
            while (!stoppingToken.IsCancellationRequested)
            {
                // 你的后台任务逻辑
                await Task.Delay(1000, stoppingToken);
            }
        }
        finally
        {
            _statusContainer.SetRunningStatus(false);
        }
    }
}

3. 在Program.cs中注册容器与API端点

var builder = WebApplication.CreateBuilder(args);

// 注册单例状态容器
builder.Services.AddSingleton<ServiceStatus>();
// 注册托管服务
builder.Services.AddHostedService<MyService>();

var app = builder.Build();

// Minimal API端点：读取状态容器中的值
app.MapGet("/service-status", (ServiceStatus status) => 
{
    return Results.Ok(new { IsRunning = status.IsRunning });
});

app.Run();

关键注意事项 #

• 线程安全：后台服务和API请求运行在不同线程，必须保证状态变量的可见性（如用volatile），复杂场景建议使用lock或线程安全集合（如ConcurrentDictionary）。
• 状态封装：尽量让状态的修改逻辑只由后台服务控制，API仅做读取操作，避免外部非法修改状态。

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