csharp-background-service

To prevent a .NET BackgroundService from crashing, implement loop-level exception handling within your execute method. Filter OperationCanceledException for graceful shutdowns and ensure unhandled errors are caught to keep periodic tasks and queue consumers running reliably.

Injecting scoped services directly into an IHostedService causes captive dependency problems. Resolve this by using IServiceScopeFactory or IDbContextFactory to create scopes for safe database access and resource management during background processing.

CancellationToken propagation in a hosted service requires passing the token to all asynchronous operations. Use PeriodicTimer to avoid overlapping ticks and ensure the token triggers a clean shutdown without leaking resources.

Build a queue-based worker by implementing a Channel-based producer-consumer pattern. Combine this with IServiceScopeFactory in your BackgroundService to safely resolve scoped dependencies and process queued background jobs.

Choose BackgroundService for long-running loops and continuous queue consumers. Use IHostedService when you only need one-time initialization or need precise control over the registration and start-stop ordering.

Correct registration and shutdown ordering for multiple hosted services is managed by the .NET generic host. Services stop in reverse order of their start sequence, ensuring clean application shutdown when CancellationToken is triggered.