Azure App Service多实例下BackgroundService单例运行及日志重复问题

针对你遇到的3实例部署下BackgroundService重复运行、日志重复的问题，以下是几种可行的解决方案：

1. 分布式锁实现单实例执行 #

这是最可靠的通用方案，通过分布式锁确保同一时间只有一个实例能执行后台任务，支持实例动态增减。

实现思路： #

在BackgroundService的ExecuteAsync方法中，先尝试获取分布式锁（可使用Azure Redis Cache或Azure Storage Blob租约），只有成功获取锁的实例才继续执行任务，其他实例进入等待状态，直到锁释放后再次尝试。

代码示例（Azure Storage Blob租约）： #

public class SingleInstanceBackgroundService : BackgroundService
{
    private readonly BlobContainerClient _containerClient;
    private const string LeaseBlobName = "background-service-lease";

    public SingleInstanceBackgroundService(BlobContainerClient containerClient)
    {
        _containerClient = containerClient;
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        while (!stoppingToken.IsCancellationRequested)
        {
            BlobClient blobClient = _containerClient.GetBlobClient(LeaseBlobName);
            await blobClient.CreateIfNotExistsAsync(cancellationToken: stoppingToken);

            // 尝试获取15分钟的租约，可根据任务周期调整
            var leaseResponse = await blobClient.AcquireLeaseAsync(TimeSpan.FromMinutes(15), cancellationToken: stoppingToken);
            if (!string.IsNullOrEmpty(leaseResponse.Value.LeaseId))
            {
                try
                {
                    // 执行你的后台任务逻辑
                    await RunBackgroundTask(stoppingToken);
                }
                finally
                {
                    // 释放租约
                    await blobClient.ReleaseLeaseAsync(leaseResponse.Value.LeaseId, cancellationToken: stoppingToken);
                }
            }

            // 任务执行完成后，等待一段时间再重试
            await Task.Delay(TimeSpan.FromMinutes(1), stoppingToken);
        }
    }

    private async Task RunBackgroundTask(CancellationToken stoppingToken)
    {
        // 你的实际后台任务代码
        Log.Information("执行后台任务，实例ID：{InstanceId}", Environment.GetEnvironmentVariable("WEBSITE_INSTANCE_ID"));
        await Task.Delay(TimeSpan.FromSeconds(30), stoppingToken);
    }
}

2. 配置实例专属应用设置 #

通过给单个实例添加专属的应用设置，让只有该实例运行后台服务，适合不需要动态调整实例的场景。

操作步骤： #

• 在Azure门户的App Service资源中，进入配置 > 应用设置
• 点击添加，创建一个键如ENABLE_BACKGROUND_SERVICE，值设为true
• 点击该设置的槽位/实例粘性，选择仅对特定实例，然后选择你要运行后台服务的那个实例
• 在BackgroundService中检查该设置：

protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
    var enableService = bool.Parse(Environment.GetEnvironmentVariable("ENABLE_BACKGROUND_SERVICE") ?? "false");
    if (!enableService)
    {
        Log.Information("当前实例未启用后台服务，退出");
        return;
    }

    // 执行后台任务逻辑
    while (!stoppingToken.IsCancellationRequested)
    {
        Log.Information("执行后台任务");
        await Task.Delay(TimeSpan.FromMinutes(5), stoppingToken);
    }
}

3. 切换为Azure Functions定时器触发器 #

如果后台任务是定时执行的，可以将逻辑迁移到Azure Functions，通过配置确保单实例运行：

• 创建定时器触发器的Function，设置触发时间
• 在Function的应用设置中添加WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT=1，限制为单实例运行
• 这种方式无需管理App Service的多实例冲突，由Azure自动处理单实例执行

4. 临时方案：改为单实例部署 #

如果业务允许减少实例数，可以直接将App Service计划调整为1个实例，这样BackgroundService自然只会运行一次。但此方案会降低应用的可用性和负载能力，仅适合测试或低流量场景。

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