Azure触发式WebJobs执行完成仍显示Running直至超时如何解决

算力阿峰

2026-9-1

问题原因

BackgroundService的StopAsync方法设计用途是供外部发起停止请求，逻辑是触发取消令牌、等待ExecuteAsync方法执行完成，本身不会终止作业进程。在ExecuteAsync内部调用该方法会出现自等待逻辑，完全无法实现通知作业结束的效果。
Azure门户、Kudu判定WebJob执行状态的核心依据是 作业对应的进程是否正常退出。只要进程没有退出，无论业务逻辑是否执行完毕，状态都会一直显示为「运行中」，直到触发默认120秒的超时规则被系统强制终止。

正确实现方案

如果你的WebJob是单次执行、跑完就结束的触发式作业（定时触发/手动触发），需要在业务逻辑执行完成后主动通知宿主正常退出进程，而不是手动调用StopAsync。

首先在服务中注入IHostApplicationLifetime实例，用它来触发宿主的正常关闭流程，这个流程会自动完成资源释放、日志冲刷等操作，不会出现脏退出。
业务逻辑全部执行完成后，调用StopApplication()方法触发宿主退出。

修正后的可运行示例代码如下：

namespace MyService
{
    public class MyService : BackgroundService
    {
        private readonly IHostApplicationLifetime _appLifetime;

        public MyService(IHostApplicationLifetime appLifetime)
        {
            _appLifetime = appLifetime;
        }

        protected override async Task ExecuteAsync(CancellationToken stoppingToken)
        {
            // 此处放置你的实际业务执行逻辑
            
            // 业务执行完成后主动触发宿主关闭，无需手动调用StopAsync
            _appLifetime.StopApplication();
        }
    }
}

注意事项

如果你部署的是连续运行类型的WebJob，这类作业本身设计为常驻进程，会一直显示「运行中」状态，不需要主动退出。
进程正常退出时返回码为0时，Kudu会将作业标记为执行成功；非0返回码会标记为执行失败，可以根据业务执行结果在退出前设置对应退出码。
构建主机时不要额外添加会强制阻塞进程不退出的逻辑，StopApplication()触发后，主机的默认生命周期管理会自动走完退出流程，进程结束后门户状态就会同步更新为已完成。

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