Durable Function应用内存过高，如何限制TaskCompletedEvent堆内存占用？

针对你遇到的堆内存被大量DurableTask.Core.History.TaskCompletedEvent填满的问题，可以通过以下几种方式限制这类事件的内存占用：

1. 调整编排实例缓存大小 #

Durable Task Framework默认会在内存中缓存最近的1000个编排实例，每个实例会保留完整的历史事件（包括TaskCompletedEvent）。你可以通过MaxOrchestrationInstanceCacheSize配置项减小缓存上限，让框架更早回收不活跃的实例，释放内存中的历史事件。

配置方式： #

• 代码配置（In-Process模型在Startup.cs，Isolated进程模型在Program.cs）：

using Microsoft.Azure.WebJobs.Extensions.DurableTask;

// In-Process模型
builder.Services.AddDurableTask(options =>
{
    // 根据业务需求设置合适值，示例为500
    options.MaxOrchestrationInstanceCacheSize = 500;
});

// Isolated进程模型
builder.Services.AddDurableTaskClient(options =>
{
    options.MaxOrchestrationInstanceCacheSize = 500;
});

• 配置文件设置（local.settings.json或Azure App Service配置）：

{
  "Values": {
    "DurableTask:MaxOrchestrationInstanceCacheSize": "500"
  }
}

2. 完成后自动清理编排历史 #

如果你的业务不需要保留已完成编排的状态和历史，可以启用PurgeHistoryOnCompletion配置，让框架在编排完成后立即清理内存中的实例和存储中的历史记录，彻底释放相关内存。

配置方式： #

• 代码配置：

builder.Services.AddDurableTask(options =>
{
    options.PurgeHistoryOnCompletion = true;
});

• 配置文件设置：

{
  "Values": {
    "DurableTask:PurgeHistoryOnCompletion": "true"
  }
}

注意：启用该选项后，无法再查询已完成编排的状态或重新播放历史，仅适用于不需要后续追溯的场景。

3. 拆分长运行/高任务量编排 #

如果你的编排包含大量活动函数调用（每个调用都会生成TaskCompletedEvent），长运行的编排会在内存中积累巨量历史事件。建议将这类编排拆分为多个短周期的子编排或链式编排，每个子编排完成后即可释放自身的历史内存。

例如，将一个执行1000次活动调用的编排，拆分为10个执行100次调用的子编排，通过CallSubOrchestratorAsync触发，每个子编排完成后内存会被及时回收。

4. 减少不必要的活动函数调用 #

检查编排逻辑，合并重复或可批量处理的操作，减少活动函数的调用次数，从根源上减少TaskCompletedEvent的生成数量。

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