From 06855df8e98612047c178df31928aa2ff4b75320 Mon Sep 17 00:00:00 2001 From: GSmithApps Date: Tue, 7 Jan 2025 04:54:37 -0600 Subject: [PATCH] doc: Clarify `UnableToAcquireLockException` (#2359) GitHub Issue https://github.com/temporalio/sdk-java/issues/2359 --- .../java/io/temporal/internal/worker/WorkflowWorker.java | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/temporal-sdk/src/main/java/io/temporal/internal/worker/WorkflowWorker.java b/temporal-sdk/src/main/java/io/temporal/internal/worker/WorkflowWorker.java index e67011911..802740ebe 100644 --- a/temporal-sdk/src/main/java/io/temporal/internal/worker/WorkflowWorker.java +++ b/temporal-sdk/src/main/java/io/temporal/internal/worker/WorkflowWorker.java @@ -355,8 +355,12 @@ public void handle(WorkflowTask task) throws Exception { if (!locked) { throw new UnableToAcquireLockException( - "Workflow lock for the run id hasn't been released by one of previous execution attempts, " - + "consider increasing workflow task timeout."); + "Workflow lock for the run id hasn't been released by one of previous execution attempts. " + + "This likely means the workflow task timed out, and the Service attempted to " + + "retry the task on the same Worker while the timed out Task had not finished yet. " + + "We suggest investigating why the Workflow Task timed out. This could mean " + + "looking at Worker resource utilization at the time in which this exception was thrown or " + + "increasing workflow task timeout."); } }