graphql-java · bbakerman · Jan 15, 2026 · Jan 13, 2026
diff --git a/src/main/java/graphql/execution/instrumentation/ChainedInstrumentation.java b/src/main/java/graphql/execution/instrumentation/ChainedInstrumentation.java
@@ -6,6 +6,7 @@
 import graphql.ExperimentalApi;
 import graphql.PublicApi;
 import graphql.execution.Async;
+import graphql.execution.DataFetcherResult;
 import graphql.execution.ExecutionContext;
 import graphql.execution.FieldValueInfo;
 import graphql.execution.instrumentation.parameters.InstrumentationCreateStateParameters;
@@ -380,6 +381,11 @@ public void onFetchedValue(Object fetchedValue) {
             contexts.forEach(context -> context.onFetchedValue(fetchedValue));
         }
 
+        @Override
+        public void onExceptionHandled(DataFetcherResult<Object> dataFetcherResult) {
+            contexts.forEach(context -> context.onExceptionHandled(dataFetcherResult));
+        }
+
         @Override
         public void onCompleted(Object result, Throwable t) {
             contexts.forEach(context -> context.onCompleted(result, t));

diff --git a/src/test/groovy/graphql/execution/instrumentation/ChainedInstrumentationStateTest.groovy b/src/test/groovy/graphql/execution/instrumentation/ChainedInstrumentationStateTest.groovy
@@ -8,6 +8,8 @@ import graphql.execution.AsyncExecutionStrategy
 import graphql.execution.instrumentation.parameters.InstrumentationCreateStateParameters
 import graphql.execution.instrumentation.parameters.InstrumentationExecutionParameters
 import graphql.execution.instrumentation.parameters.InstrumentationValidationParameters
+import graphql.schema.DataFetcher
+import graphql.schema.DataFetchingEnvironment
 import graphql.validation.ValidationError
 import spock.lang.Specification
 
@@ -227,6 +229,78 @@ class ChainedInstrumentationStateTest extends Specification {
         assertCalls(c)
     }
 
+    def "basic chaining and state management when exception raised in data fetching"() {
+
+        def a = new NamedInstrumentation("A")
+        def b = new NamedInstrumentation("B")
+        def c = new NamedInstrumentation("C")
+        def nullState = new SimplePerformantInstrumentation()
+
+        def chainedInstrumentation = new ChainedInstrumentation([
+                a,
+                b,
+                nullState,
+                c,
+        ])
+
+        def query = """
+        query HeroNameAndFriendsQuery {
+            hero {
+                id
+            }
+        }
+        """
+
+        def expected = "onExceptionHandled:fetch-id"
+
+
+        when:
+        def strategy = new AsyncExecutionStrategy()
+        def schema = StarWarsSchema.starWarsSchema
+        def graphQL = GraphQL
+                .newGraphQL(schema.transform { schemaBuilder ->
+                    // throw exception when fetching the hero id
+                    def exceptionDataFetcher = new DataFetcher() {
+                        @Override
+                        Object get(DataFetchingEnvironment environment) {
+                            throw new RuntimeException("Data fetcher exception")
+                        }
+                    }
+                    schemaBuilder.codeRegistry(schema.codeRegistry.transform {
+                        it.dataFetcher(
+                                schema.getObjectType("Human"),
+                                schema.getObjectType("Human").getFieldDefinition("id"),
+                                exceptionDataFetcher
+                        )
+                        it.dataFetcher(
+                                schema.getObjectType("Droid"),
+                                schema.getObjectType("Droid").getFieldDefinition("id"),
+                                exceptionDataFetcher
+                        )
+                        return it
+                    }
+                    )
+                })
+                .queryExecutionStrategy(strategy)
+                .instrumentation(chainedInstrumentation)
+                .build()
+
+        graphQL.execute(query)
+
+        then:
+
+        chainedInstrumentation.getInstrumentations().size() == 4
+
+        a.executionList.any { it == expected }
+        b.executionList.any { it == expected }
+        c.executionList.any { it == expected }
+
+        assertCalls(a)
+        assertCalls(b)
+        assertCalls(c)
+
+    }
+
     def "empty chain"() {
         def chainedInstrumentation = new ChainedInstrumentation(Arrays.asList())
 

diff --git a/...roovy/graphql/execution/instrumentation/TestingFieldFetchingInstrumentationContext.groovy b/...roovy/graphql/execution/instrumentation/TestingFieldFetchingInstrumentationContext.groovy
@@ -1,9 +1,16 @@
 package graphql.execution.instrumentation
 
+import graphql.execution.DataFetcherResult
+
 class TestingFieldFetchingInstrumentationContext extends TestingInstrumentContext<Object> implements FieldFetchingInstrumentationContext {
 
     TestingFieldFetchingInstrumentationContext(Object op, Object executionList, Object throwableList, Boolean useOnDispatch) {
         super(op, executionList, throwableList, useOnDispatch)
     }
+
+    @Override
+    void onExceptionHandled(DataFetcherResult<Object> dataFetcherResult) {
+        executionList << "onExceptionHandled:$op"
+    }
 }
 
diff --git a/src/test/groovy/graphql/execution/instrumentation/TestingInstrumentContext.groovy b/src/test/groovy/graphql/execution/instrumentation/TestingInstrumentContext.groovy
@@ -1,7 +1,5 @@
 package graphql.execution.instrumentation
 
-import java.util.concurrent.CompletableFuture
-
 class TestingInstrumentContext<T> implements InstrumentationContext<T> {
     def op
     def start = System.currentTimeMillis()