karatelabs/karate · error · RuntimeException

Timeout waiting for Karate test events after

Error message

Timeout waiting for Karate test events after ${timeoutMinutes} minutes

What it means

StreamingTestIterator polls the Karate event queue with a timeout (default in minutes) while JUnit requests the next DynamicNode. If no event arrives within the window and the run is not marked finished, it assumes the producer died and throws this timeout error.

Solutions

1. Fix the hanging feature: add timeouts to HTTP/driver calls and avoid indefinite waits
2. Increase the timeout configuration if features legitimately run longer than the window
3. Check producer thread logs for a crash that prevented the completion event

Example fix

// before (feature hangs)
* configure responseTimeout = 30000
// after
* configure responseTimeout = 30000
* driver / http calls with explicit timeouts and no infinite waits

// ensure features cannot hang: set timeouts in karate config
// * configure responseTimeout = 30000; driver waits bounded

null

try {
  iterator.hasNext();
} catch (RuntimeException e) {
  if (e.getMessage() != null && e.getMessage().contains("Timeout waiting for Karate test events")) {
    log.error("Karate producer stalled; aborting suite");
    return false;
  }
  throw e;
}

When it happens

Trigger: No TestEvent arrives on the queue within timeoutMinutes while pollForNextNode loops — e.g. the feature-executing thread hung or died without publishing an end event.

Common situations: A Karate feature blocked indefinitely (network call without timeout, infinite wait), JVM pause, or producer thread crashed before signalling completion.

Understand the failure class

Background: Request timed out: what client-side request timeouts mean across libraries (Request timed out, TIMED_OUT, APITimeoutError) — this error's family across 39 libraries.

• Timeouts: ETIMEDOUT, deadlines, and hung requests — what actually expires when a request times out.

Related errors

• Timeout waiting for available driver for scenario
• timed out waiting for promise
• Interrupted while publishing test event
• Pool exhausted for scenario
• HTTP endpoint not available

AI-assisted analysis of karatelabs/karate@a22eb90246 (2026-09-12). Data as JSON: /api/errors/cb57363b9943ad2a. Report an issue: GitHub.

Appendix: source

Thrown at karate-junit6/src/main/java/io/karatelabs/junit6/StreamingTestIterator.java:141

    }

    /**
     * Returns this iterator as a {@link Stream} for use with {@code @TestFactory}.
     *
     * @return a sequential stream of dynamic nodes
     */
    public Stream<DynamicNode> stream() {
        return StreamSupport.stream(
                Spliterators.spliteratorUnknownSize(this, Spliterator.ORDERED),
                false
        );
    }

    private DynamicNode pollForNextNode() throws InterruptedException {
        while (!finished) {
            TestEvent event = eventQueue.poll(timeoutMinutes, TimeUnit.MINUTES);
            if (event == null) {
                throw new RuntimeException("Timeout waiting for Karate test events after " + timeoutMinutes + " minutes");
            }

            DynamicNode node = processEvent(event);
            if (node != null) {
                return node;
            }
        }
        return null;
    }

    private DynamicNode processEvent(TestEvent event) {
        return switch (event) {
            case TestEvent.FeatureStart(Feature feature) -> {
                currentFeature = feature;
                currentFeatureTests.clear();
                yield null; // No node yet, wait for scenarios
            }

View on GitHub (pinned to a22eb90246)