Azure Durable Entity异步任务无限挂起问题排查求助

问题背景 #

正在排查Azure Durable Entity中异步任务无限挂起的问题，此功能之前正常运行，但现在所有编排器都处于Running状态。

实体代码 #

public MyEntity : IMyEntity {

[JsonIgnore]
private MyService _myService;

[JsonProperty]
public string Property1;
..
..

public Task GetJobs() {
return _myService.GetAllValues(); // 该服务API调用数据库
}

}

编排器调用代码 #

..
..
var entity = new EntityId("MyEntity", id);
var entityProxy = context.CreateEntityProxy<IMyEntity>(MyEntity);

await entityProxy.GetJobs(); // 编排器无限挂起

已尝试操作 #

• 重启函数应用
• 确认数据库正常运行并接受连接
• 在MyService类的GetValues方法中设置调试断点，但代码未命中

疑问点 #

1. 挂起问题的根本原因是什么？
2. 若编排器中调用返回标准数据的数据库属于非确定性调用，还有哪些操作属于此类？
3. 将数据库调用移至Activity函数替代entityProxy.GetJobs()可行，但不确定其扩展性如何，求经验分析。

分析建议 #

根本原因 #

Durable Entity的方法执行必须满足确定性要求，且不能包含依赖外部系统的异步操作（如数据库调用）。Entity的执行依赖状态的序列化/反序列化来保证可靠性与重入性，直接在Entity方法中调用数据库这类外部异步操作会打破执行逻辑的确定性，导致Durable Task Framework调度阻塞，进而让编排器无限等待响应。

至于断点未命中，是因为违反执行约束后，框架可能未调度该方法执行，或是调度过程中出现静默故障，导致代码未走到断点逻辑。

非确定性操作范围 #

除数据库调用外，以下操作均属于非确定性或不适合在编排器/Entity中执行的操作：

• 调用外部HTTP API、第三方服务
• 读写本地文件系统或外部存储（如Blob、队列，除非使用Durable Functions内置绑定）
• 生成随机数、获取当前系统时间（DateTime.Now/DateTime.UtcNow）
• 访问动态变化的环境变量或配置
• 任何依赖外部状态、可能返回不同结果的操作

Activity函数替代方案的扩展性 #

将数据库调用移至Activity函数是符合Durable Functions最佳实践的方案，扩展性无需担忧：

• 自动缩放：Activity函数由Azure Functions缩放控制器自动管理，可根据负载动态调整实例数量，应对高并发场景。
• 故障隔离：Activity函数执行与Entity/编排器解耦，外部依赖故障不会直接影响Entity状态一致性。
• 重试机制：可通过[ActivityTrigger]的RetryOptions配置处理数据库调用的临时故障，提升可靠性。
• 监控追踪：Activity函数执行可通过Azure Monitor监控，便于问题排查。

额外建议 #

• 确保Entity状态仅包含可序列化属性（代码中_myService用[JsonIgnore]标记是正确的，因为服务实例无法被序列化）。
• 所有依赖外部系统的操作都应放在Activity函数中，Entity仅负责维护状态和处理纯逻辑操作。
• 检查Durable Functions依赖的Azure存储账户是否正常，存储故障也可能导致编排器挂起。

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