IHostedService와 BackgroundService
.NET 호스트 내에서 백그라운드 작업을 실행하도록 IHostedService와 추상 BackgroundService를 구현합니다.
IHostedService와 BackgroundService은(는) CoddyKit의 무료 C# Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 C# Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
백그라운드 서비스란 무엇입니까?
백그라운드 서비스는 ASP.NET Core 앱과 함께 장시간 실행되는 작업을 수행합니다. 예를 들어 큐를 처리하거나, 예약된 작업을 실행하거나, 리소스를 모니터링합니다. .NET은 두 가지 인터페이스를 제공합니다: IHostedService(최소 기능)와 추상 BackgroundService(반복 작업에 적합).
IHostedService 인터페이스
IHostedService에는 두 가지 메서드가 있습니다: StartAsync(호스트가 시작될 때 호출됨)와 StopAsync(정상 종료 중에 호출됨)입니다. 시작 및 종료 시 한 번만 수행할 작업에 적합합니다.
public class DatabaseMigratorService : IHostedService
{
private readonly IServiceScopeFactory _scopeFactory;
public DatabaseMigratorService(IServiceScopeFactory sf) => _scopeFactory = sf;
public async Task StartAsync(CancellationToken ct)
{
using var scope = _scopeFactory.CreateScope();
var db = scope.ServiceProvider.GetRequiredService<AppDbContext>();
await db.Database.MigrateAsync(ct);
}
public Task StopAsync(CancellationToken ct) => Task.CompletedTask;
}
builder.Services.AddHostedService<DatabaseMigratorService>();BackgroundService: 장시간 실행되는 반복 작업
BackgroundService는 IHostedService를 구현하는 추상 클래스이며, 앱의 수명 동안 실행되는 메서드인 ExecuteAsync(CancellationToken)을 제공합니다.
public class HeartbeatService : BackgroundService
{
private readonly ILogger<HeartbeatService> _logger;
public HeartbeatService(ILogger<HeartbeatService> l) => _logger = l;
protected override async Task ExecuteAsync(CancellationToken ct)
{
_logger.LogInformation("Heartbeat service started");
while (!ct.IsCancellationRequested)
{
_logger.LogInformation("Heartbeat: {Time}", DateTime.UtcNow);
await Task.Delay(TimeSpan.FromSeconds(30), ct);
}
_logger.LogInformation("Heartbeat service stopping");
}
}
builder.Services.AddHostedService<HeartbeatService>();범위 지정 서비스 사용
백그라운드 서비스는 싱글턴입니다. DbContext와 같은 범위 지정 서비스를 사용하려면 작업 단위마다 항상 IServiceScopeFactory를 사용해 새 범위를 만들어야 합니다.
public class DataSyncService : BackgroundService
{
private readonly IServiceScopeFactory _factory;
private readonly ILogger<DataSyncService> _log;
public DataSyncService(IServiceScopeFactory f, ILogger<DataSyncService> l)
{ _factory = f; _log = l; }
protected override async Task ExecuteAsync(CancellationToken ct)
{
while (!ct.IsCancellationRequested)
{
using (var scope = _factory.CreateScope())
{
var db = scope.ServiceProvider.GetRequiredService<AppDbContext>();
await SyncDataAsync(db, ct);
} // scope and DbContext disposed here
await Task.Delay(TimeSpan.FromMinutes(5), ct);
}
}
}정상 종료
호스트가 종료되면 취소 토큰을 발생시킵니다. ExecuteAsync는 이 토큰을 확인하고 정리 작업을 수행해야 합니다. 호스트는 강제 종료하기 전에 최대 5초(기본값)까지 기다립니다.
protected override async Task ExecuteAsync(CancellationToken ct)
{
try
{
while (!ct.IsCancellationRequested)
{
await DoWorkAsync(ct);
await Task.Delay(1000, ct);
}
}
catch (OperationCanceledException)
{
// Normal shutdown — not an error
_logger.LogInformation("Service stopping due to cancellation");
}
finally
{
// Cleanup
await CleanupAsync();
}
}채널 기반 백그라운드 큐
일반적인 패턴은 백그라운드 서비스가 채널 큐에서 읽는 동안 HTTP 엔드포인트가 작업 항목을 큐에 추가하는 방식입니다. 이렇게 하면 요청 처리와 작업 처리를 분리할 수 있습니다.
public class BackgroundTaskQueue
{
private readonly Channel<Func<CancellationToken, Task>> _queue
= Channel.CreateBounded<Func<CancellationToken, Task>>(100);
public ValueTask QueueAsync(Func<CancellationToken, Task> job)
=> _queue.Writer.WriteAsync(job);
public IAsyncEnumerable<Func<CancellationToken, Task>> DequeueAllAsync(
CancellationToken ct)
=> _queue.Reader.ReadAllAsync(ct);
}
// Register and use:
builder.Services.AddSingleton<BackgroundTaskQueue>();
builder.Services.AddHostedService<QueueProcessorService>();백그라운드 서비스의 오류 처리
ExecuteAsync에서 처리되지 않은 예외가 발생하면 서비스가 조용히 중단될 수 있습니다. 주 반복문을 try/catch로 감싸고 오류를 기록하여 개별 실패가 발생해도 서비스가 계속 실행되도록 하세요.
protected override async Task ExecuteAsync(CancellationToken ct)
{
while (!ct.IsCancellationRequested)
{
try
{
await ProcessNextBatchAsync(ct);
}
catch (OperationCanceledException) when (ct.IsCancellationRequested)
{
break; // normal shutdown
}
catch (Exception ex)
{
_logger.LogError(ex, "Background processing error. Retrying in 5s.");
await Task.Delay(5000, ct); // backoff before retry
}
}
}StopAsync 및 종료 제한 시간
정리 작업을 수행하도록 StopAsync를 재정의하세요. 호스트는 종료 토큰을 전달합니다. 정리 작업이 제한 시간보다 오래 걸리면 프로세스는 무조건 종료됩니다.
public override async Task StopAsync(CancellationToken stoppingToken)
{
_logger.LogInformation("Service is stopping...");
// Signal internal work to stop
_internalCts.Cancel();
// Wait for the Execute loop to complete (up to timeout)
await base.StopAsync(stoppingToken);
_logger.LogInformation("Service stopped");
}
// Increase the shutdown timeout if needed:
builder.Services.Configure<HostOptions>(opt =>
opt.ShutdownTimeout = TimeSpan.FromSeconds(30));여러 백그라운드 서비스
여러 호스팅 서비스를 등록하면 모두 동시에 실행됩니다. 호스트는 등록된 순서대로 서비스를 시작하고 역순으로 중지합니다.
builder.Services.AddHostedService<DatabaseMigratorService>(); // startup task
builder.Services.AddHostedService<MetricsCollectorService>(); // continuous
builder.Services.AddHostedService<EmailNotificationService>(); // continuous
builder.Services.AddHostedService<CacheWarmupService>(); // startup task
// All run concurrently after app start
// Stopped in reverse registration order on shutdown실전: 주문 처리 작업자
적절한 범위 관리와 오류 처리를 적용하여 데이터베이스 큐에서 대기 중인 주문을 처리하는 백그라운드 서비스입니다.
public class OrderProcessorService : BackgroundService
{
private readonly IServiceScopeFactory _factory;
private readonly ILogger<OrderProcessorService> _log;
public OrderProcessorService(IServiceScopeFactory f, ILogger<OrderProcessorService> l)
{ _factory = f; _log = l; }
protected override async Task ExecuteAsync(CancellationToken ct)
{
while (!ct.IsCancellationRequested)
{
try
{
using var scope = _factory.CreateScope();
var processor = scope.ServiceProvider.GetRequiredService<IOrderProcessor>();
int count = await processor.ProcessPendingAsync(ct);
_log.LogInformation("Processed {Count} orders", count);
}
catch (Exception ex) when (!ct.IsCancellationRequested)
{
_log.LogError(ex, "Order processing failed");
}
await Task.Delay(TimeSpan.FromSeconds(10), ct);
}
}
}빠른 확인
백그라운드 서비스는 DbContext를 직접 주입하지 않고 IServiceScopeFactory를 사용해야 하는 이유는 무엇입니까?
복습: IHostedService 및 BackgroundService
핵심 요점:
IHostedService: StartAsync/StopAsync — 시작 및 종료 작업에 사용합니다BackgroundService: ExecuteAsync 반복문 — 지속적인 백그라운드 작업에 사용합니다- 백그라운드 서비스 내부의 범위 지정 종속성에는 항상
IServiceScopeFactory를 사용합니다 - 정상 종료를 위해 모든 await에서 취소 토큰을 확인합니다
- 오류가 발생해도 서비스가 중단되지 않도록 반복문 본문을 try/catch로 감쌉니다
- 정리 작업에 5초 넘게 필요한 경우
HostOptions.ShutdownTimeout을 사용합니다
자주 묻는 질문
“IHostedService와 BackgroundService” 강의는 무료인가요?
네 — “IHostedService와 BackgroundService” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 C# Academy 강의 전체를 잠금 해제할 수 있습니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“IHostedService와 BackgroundService”에서 뭘 배우나요?
.NET 호스트 내에서 백그라운드 작업을 실행하도록 IHostedService와 추상 BackgroundService를 구현합니다. 브라우저에서 직접 실행하는 실습 코드로 C# Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
C# Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 C# Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“IHostedService와 BackgroundService” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 C# Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 C# Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- IHostedService와 BackgroundService
- Worker Service 프로젝트
- 주기적 작업과 타이머
- Quartz.NET 예약 작업