ASP.NET MVC项目中如何通过按钮点击启动后台服务

首先明确核心问题：IHostedService的StartAsync是由.NET托管环境自动调用的生命周期方法，不能直接通过外部请求触发。你需要给后台服务添加手动控制逻辑，再通过API控制器作为中间层接收前端请求，间接控制服务启停。

步骤1：修改TimeHostedService，添加手动控制逻辑 #

调整服务类，新增可外部调用的启停方法，用状态变量控制循环，同时修正原代码中_cancellationToken未初始化的问题：

public class TimeHostedService : IHostedService, IDisposable
{
    private readonly ILogger<TimeHostedService> _logger;
    private readonly IEmailService _emailService;
    private bool _isRunning; // 控制服务运行状态的标记
    private CancellationTokenSource _cts; // 手动控制取消的Token源

    public TimeHostedService(ILogger<TimeHostedService> logger, IEmailService emailService)
    {
        _logger = logger;
        _emailService = emailService;
        _cts = new CancellationTokenSource();
    }

    // 框架自动调用的初始化方法，保持原生命周期逻辑
    public Task StartAsync(CancellationToken cancellationToken)
    {
        _logger.LogInformation("Timed background service initialized");
        return Task.CompletedTask;
    }

    // 供外部调用的手动启动方法
    public async Task StartManualAsync()
    {
        if (_isRunning) return; // 避免重复启动
        _isRunning = true;
        _cts = new CancellationTokenSource(); // 重置取消源

        _logger.LogInformation("Timed background service started manually");
        while (_isRunning && !_cts.Token.IsCancellationRequested)
        {
            await _emailService.SendMailCampainStatusAsync();
            await Task.Delay(TimeSpan.FromSeconds(1), _cts.Token);
            _logger.LogInformation("Background service is running...");
        }
    }

    // 供外部调用的手动停止方法
    public void StopManual()
    {
        if (!_isRunning) return;
        _isRunning = false;
        _cts.Cancel();
        _logger.LogInformation("Timed background service stopped manually");
    }

    public Task StopAsync(CancellationToken cancellationToken)
    {
        StopManual(); // 框架停止时复用手动停止逻辑
        return Task.CompletedTask;
    }

    public void Dispose()
    {
        _cts.Dispose();
    }
}

步骤2：创建API控制器作为中间层 #

新建控制器，通过依赖注入获取TimeHostedService实例，暴露接口供前端调用：

[Route("api/[controller]")]
[ApiController]
public class BackgroundServiceController : ControllerBase
{
    private readonly TimeHostedService _timeHostedService;

    // 必须注册服务为单例，才能保证控制器和托管环境使用同一个实例
    public BackgroundServiceController(TimeHostedService timeHostedService)
    {
        _timeHostedService = timeHostedService;
    }

    [HttpPost("Start")]
    public IActionResult StartService()
    {
        // 异步启动服务，避免阻塞HTTP请求
        _ = _timeHostedService.StartManualAsync();
        return Ok("Background service started successfully");
    }

    [HttpPost("Stop")]
    public IActionResult StopService()
    {
        _timeHostedService.StopManual();
        return Ok("Background service stopped successfully");
    }
}

步骤3：在Program.cs中注册服务为单例 #

确保服务以单例模式注册，保证控制器和框架托管的是同一个实例：

builder.Services.AddSingleton<IHostedService, TimeHostedService>();
// 注册你的邮件服务（替换为实际实现类）
builder.Services.AddScoped<IEmailService, YourEmailServiceImpl>();

步骤4：修改前端AJAX代码 #

调整请求URL指向控制器接口，同时阻止表单默认提交行为：

<form>
    <button type="button" id="startServiceBtn">Start Background Service</button>
    <button type="button" id="stopServiceBtn">Stop Background Service</button>
</form>
<script>
$(document).ready(function() {
    $("#startServiceBtn").click(function(){
        $.ajax({
            type: "POST",
            url: "/api/BackgroundService/Start",
            success: function(response) {
                alert(response);
            },
            error: function(xhr) {
                alert("Failed to start service: " + xhr.responseText);
            }
        });
    });

    $("#stopServiceBtn").click(function(){
        $.ajax({
            type: "POST",
            url: "/api/BackgroundService/Stop",
            success: function(response) {
                alert(response);
            },
            error: function(xhr) {
                alert("Failed to stop service: " + xhr.responseText);
            }
        });
    });
});
</script>

关键注意事项 #

• 永远不要直接调用IHostedService的StartAsync/StopAsync，这些是框架生命周期管理的专属方法。
• 服务必须注册为单例，否则控制器会获取到新的服务实例，无法控制已启动的服务。
• 手动启动服务时用_ =丢弃任务，避免HTTP请求因等待长期运行的服务而超时。

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