.NET 8 Isolated类基Durable Functions无法调试及查看日志

核心现象 #

使用类基TaskActivity/TaskOrchestrator替代函数基实现后：

• Orchestrator主机日志显示启动并完成，但自身LogInformation无输出
• Activity无任何执行痕迹（无法调试、无日志）
• 回退到函数基（带[ActivityTrigger]/[OrchestrationTrigger]的函数）后恢复正常

排查与修复步骤 #

1. 确认Durable Task包与服务注册 #

• 确保安装适配.NET 8 Isolated的Microsoft.Azure.Functions.Worker.Extensions.DurableTask包（建议v1.0.0+稳定版）
• 在Program.cs中必须显式注册Durable服务：

builder.Services.AddDurableTask();

• 检查host.json日志配置，开启Durable相关日志追踪：

{
  "logging": {
    "logLevel": {
      "DurableTask": "Information",
      "Microsoft.Azure.Functions.Worker.Extensions.DurableTask": "Information"
    }
  }
}

2. 类基实现的特性与调用校验 #

• 特性名称必须严格匹配：[DurableTask(nameof(MyActivity))]中的名称要和调用时的名称完全一致。如果自动生成的CallMyActivityAsync扩展方法失效，改用手动调用：

// 替代自动生成的扩展方法
return await context.CallActivityAsync<string>(nameof(MyActivity), input);

• Orchestrator日志验证：给ReplaySafe日志添加Orchestration ID，确认日志是否真的未输出：

logger.LogInformation("Orchestrator {InstanceId} running", context.OrchestrationInstance.InstanceId);

3. Isolated模式宿主配置检查 #

• Activity构造函数注入ILogger<MyActivity>需要Worker注册日志服务，确保Program.cs中有：

builder.Services.AddLogging();

• 确认Worker启动逻辑完整：

var host = builder.Build();
host.Run();

4. 深度调试技巧 #

• 开启Durable Task调试级日志：在host.json中设置"DurableTask": "Debug"，查看是否有Activity调度的隐性错误（比如队列消息未处理、实例启动失败）
• 检查后端存储队列：本地调试时查看AzureWebJobsStorage对应的存储账户，确认是否有未消费的Activity队列消息（这说明宿主未正确监听Activity任务）

关键差异说明 #

类基实现依赖源代码生成器自动注册任务，而函数基依赖[ActivityTrigger]显式注册。如果源代码生成器未生效（比如项目SDK版本不匹配、缺少生成器包），类基的Activity/Orchestrator不会被宿主识别，最终导致Orchestrator看似完成但未调度Activity。

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