如何限制Azure定时器触发器仅在单个实例运行？已用Singleton仍无效

问题根源 #

你使用的SingletonMode.Listener仅控制监听器的单例性——即只有一个实例会监听定时器的触发事件，但监听器触发后，任务仍可能被分发到多个实例执行，因此无法实现单实例运行的目标。

可行解决方案 #

1. 切换为函数级单例配置 #

将SingletonMode.Listener替换为SingletonMode.Function，这样整个函数的执行过程会被全局锁定，同一时间仅允许一个实例运行：

[Singleton(Mode = SingletonMode.Function)]
public static async Task Run([TimerTrigger("0 */5 * * * *")] TimerInfo myTimer, ILogger log)
{
    // 你的业务逻辑代码
}

2. 手动实现分布式存储锁（兜底方案） #

如果内置Singleton特性仍不生效，可以借助Azure存储账户的Blob租约实现分布式锁，确保绝对的单实例执行：

• 先引入Microsoft.Azure.WebJobs.Extensions.Storage NuGet包
• 在函数内添加锁逻辑：

public static async Task Run([TimerTrigger("0 */5 * * * *")] TimerInfo myTimer, ILogger log, [Blob("locks/timer-execution-lock")] CloudBlockBlob lockBlob)
{
    // 设定锁超时时间（需长于函数预期执行时间）
    var leaseId = await lockBlob.AcquireLeaseAsync(TimeSpan.FromMinutes(15));
    try
    {
        // 执行你的业务逻辑
        log.LogInformation("函数单实例执行中");
    }
    finally
    {
        // 执行完成后释放锁
        await lockBlob.ReleaseLeaseAsync(leaseId);
    }
}

3. 检查运行时版本与存储依赖 #

• 确保函数应用使用Azure Functions Runtime v3及以上版本，早期版本对Singleton特性的支持存在缺陷
• Singleton特性依赖函数应用绑定的默认存储账户，需确认该存储账户状态正常、权限配置无异常

4. 临时调整实例数（不推荐长期使用） #

若只是临时测试需求，可直接将App Service计划的实例数设置为1，但此操作会影响同一计划下的其他应用，不适合生产环境长期使用。

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