.NET 8 Durable Function本地VS2022调试无法捕获Activity超时异常

问题概述 #

开发用于大文件上传的Durable Function时，本地测试Activity超时重试逻辑遇到异常：

• 已在host.json中设置全局函数超时"functionTimeout": "00:01:00"，Activity通过Task.Delay(TimeSpan.FromHours(1))模拟超时场景
• 预期Orchestrator能捕获TaskFailedException并执行重试逻辑，但本地调试时dotnet.exe进程直接终止，调试会话结束，无法进入catch块
• 部署到Azure后，Orchestrator可正常捕获TaskFailedException，逻辑符合预期

核心原因 #

本地Azure Functions宿主环境中，全局functionTimeout是硬限制，触发后会直接终止整个进程，而非将超时信号转化为Durable框架的TaskFailedException传递给Orchestrator。而Azure云端的Durable运行时会独立管理Activity的生命周期，超时后能正确抛出异常供Orchestrator处理。

解决方案 #

1. 为单个Activity设置独立超时（推荐） #

调用CallActivityAsync时传入Activity级别的超时参数，优先级高于全局functionTimeout，Durable框架会主动终止Activity并抛出TaskFailedException，避免宿主进程崩溃：

[Function(nameof(RunOrchestrator))]
public static async Task RunOrchestrator([OrchestrationTrigger] TaskOrchestrationContext context)
{
    var logger = context.CreateReplaySafeLogger(context.Name);
    var uploadRequest = context.GetInput<UploadRequest>();

    try
    {
        // 为当前Activity设置1分钟超时
        await context.CallActivityAsync(nameof(ResumeUpload), uploadRequest, TimeSpan.FromMinutes(1));
    }
    catch (TaskFailedException ex)
    {
        logger.LogError(ex, "Activity执行超时，准备恢复上传");
        // 此处添加重试/恢复上传逻辑
    }
}

2. 升级Azure Functions Core Tools #

旧版本的本地工具可能存在Durable超时处理的bug，升级到最新版可解决部分兼容性问题：
打开终端执行：

npm install -g azure-functions-core-tools@4 --unsafe-perm true

3. 调整全局超时（不推荐） #

若必须依赖全局超时，可临时延长host.json中的functionTimeout，同时确保Activity超时短于全局超时，避免宿主进程被强制终止：

{
  "version": "2.0",
  "functionTimeout": "00:05:00",
  // 其他配置...
}

验证效果 #

修改后重新启动本地调试，Activity超时后，Durable框架会抛出TaskFailedException，Orchestrator的catch块可正常捕获并执行后续逻辑，不会导致进程崩溃。

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