[Bug]: withStartupTimeout() changes the startup timeout of all containers that use the default wait strategy
Maintainer antworten meist innerhalb von 1 Tag
Bewertung
- Schwierigkeit
- 2/5
- Geschätzter Aufwand
- 1-3 Stunden
- Anfängerfreundlichkeit
- 64/100
Rechercherichtung
Der gemeinsame Zustand ist DEFAULT_WAIT_STRATEGY in core/src/main/java/org/testcontainers/containers/GenericContainer.java (Felder um die Zeilen 177-183, auch referenziert aus ContainerDef.java Zeile 61); getWaitStrategy() (~Zeile 885) gibt ihn zurück und withStartupTimeout(Duration) (~Zeile 1221) mutiert ihn in-place. Beginne damit, den Reproduktionstest aus dem Bericht unter core/src/test/java/org/testcontainers/containers/ hinzuzufügen und ./gradlew :testcontainers:test --tests 'org.testcontainers.containers.DefaultWaitStrategyTimeoutTest' auszuführen, um zu beobachten, wie er fehlschlägt, und bestätige dann, dass die Standardstrategie pro Container kopiert wird, bevor der Timeout angewendet wird. Fertig bedeutet, dass der neue Test besteht und keine Strategieinstanz eines anderen Containers mutiert wird. Beachte, dass die Person, die das Problem gemeldet hat, hier bereits einen Patch angeboten hat, also koordiniere dich, bevor du beginnst.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Module
Core
Testcontainers version
2.0.5
Using the latest Testcontainers version?
Yes
Host OS
macOS 27.2.1
Host Arch
ARM
Docker version
Client:
Version: 29.8.2
API version: 1.56
Go version: go1.26.8
Git commit: 7fc2dff
Built: Wed Sep 30 19:32:03 2026
OS/Arch: darwin/arm64
Context: desktop-linux
Server: Docker Desktop 4.94.0 (241994)
Engine:
Version: 29.8.2
API version: 1.56 (minimum version 1.40)
Go version: go1.26.8
Git commit: 8af9fe3
Built: Wed Sep 30 19:31:50 2026
OS/Arch: linux/arm64
Experimental: false
containerd:
Version: v2.3.6
GitCommit: ee2735368117d2eb259779949d5e75cdafec9761
runc:
Version: 1.5.1
GitCommit: v1.5.1-0-g8f2685a4
docker-init:
Version: 0.19.0
GitCommit: de40ad0
What happened?
withStartupTimeout(Duration) on a container without its own wait strategy changes the startup timeout of all containers in the JVM that use the default wait strategy.
Expected: the timeout applies only to the container where it is set.
Actual: other containers get this timeout too. A short timeout on one container makes another container fail. The result depends on the order of tests in the JVM, so it looks like a flaky test in another class.
Reproduction. Put this test in core/src/test/java/org/testcontainers/containers/ and run
./gradlew :testcontainers:test --tests 'org.testcontainers.containers.DefaultWaitStrategyTimeoutTest':
package org.testcontainers.containers;
import org.junit.jupiter.api.Test;
import java.time.Duration;
class DefaultWaitStrategyTimeoutTest {
@Test
void startupTimeoutOfOneContainerDoesNotChangeOtherContainers() {
// Never started. Only sets a short timeout for itself.
new GenericContainer<>("alpine:3.17").withStartupTimeout(Duration.ofSeconds(2));
// Default wait strategy (60 seconds). The port opens after 5 seconds.
try (
GenericContainer<?> slow = new GenericContainer<>("alpine:3.17")
.withExposedPorts(8080)
.withCommand("sh", "-c", "sleep 5; while true; do nc -l -p 8080; done")
) {
slow.start();
}
}
}
- On
main(e16dca9ea): the test fails after about 3 seconds withContainerLaunchException(log below). - Without the first line (
new GenericContainer<>(...).withStartupTimeout(...)): the test passes after about 6 seconds.
Cause (links to main at e16dca9ea):
DEFAULT_WAIT_STRATEGYis onestaticinstance. Every container withoutwaitingFor(...)points to it: thewaitStrategyfield andContainerDef.getWaitStrategy()returns this shared instance.withStartupTimeout(Duration)callsgetWaitStrategy().withStartupTimeout(...), so it changes the shared instance itself.
Relevant log output
org.testcontainers.containers.ContainerLaunchException: Container startup failed for image alpine:3.17
Caused by: org.testcontainers.containers.ContainerLaunchException: Could not create/start container
Caused by: org.testcontainers.containers.ContainerLaunchException: Timed out waiting for container port to open (localhost ports: [55831] should be listening)
Additional Information
A possible fix: give the container its own default strategy before changing the timeout. With this change, the test above passes:
public SELF withStartupTimeout(Duration startupTimeout) {
if (getWaitStrategy() == DEFAULT_WAIT_STRATEGY) {
waitingFor(Wait.defaultWaitStrategy());
}
getWaitStrategy().withStartupTimeout(startupTimeout);
return self();
}
I can open a PR with this fix and the test if this direction is OK for you.
I found this while working on #12103: JdbcDatabaseContainer.withStartupTimeoutSeconds() must not change the shared instance either. #12103 is in draft until I fix it.
- Vorherrschende Sprache
- Java
- Sterne
- 8.8k
- Forks
- 2k
- Ø Merge
- 5 T. 4 Std.
- Gemergte PRs (30 T.)
- 17
Entwicklungsumgebung
Startet den Dev-Container des Projekts im Browser, mit Ihrem eigenen GitHub-Konto.
- Enthält ein Dockerfile oder eine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus testcontainers/testcontainers-java
-
[Enhancement]: Document why singleton containers are required under Spring's test context cachingEvtl. vergeben @zakaullah075 hat das vor 93 Tagen übernommen. Offentype/enhancement
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 85/100
testcontainers/testcontainers-java#11967 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
[Bug]: Cannot reuse Selenium BrowserWebDriverContainers under LinuxEvtl. vergeben @kdelay hat das vor 115 Tagen übernommen. Offentype/bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
testcontainers/testcontainers-java#11941 ·
Maintainer antworten meist innerhalb von 1 Tag
-
[Bug]: DockerDesktopClientProviderStrategy is always applicableEvtl. vergeben @seonwooj0810 hat das vor 164 Tagen übernommen. Offentype/bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 74/100
testcontainers/testcontainers-java#11829 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
[Enhancement]: cleanup document after removing junit4 supportEvtl. vergeben @SJvaca30 hat das vor 171 Tagen übernommen. Offentype/enhancement
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 65/100
testcontainers/testcontainers-java#11578 ·
Maintainer antworten meist innerhalb von 1 Tag
-
[Feature]: Presto Module uses the outdated Docker Image of `ghcr.io/trinodb/presto` and needs to be updated to `prestodb/presto`Evtl. vergeben @linghengqian hat das vor 854 Tagen übernommen. Offenhelp wanted type/feature
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
testcontainers/testcontainers-java#8657 · 4 Kommentare ·
Maintainer antworten meist innerhalb von 1 Tag
Alle Issues in testcontainers/testcontainers-java
Ähnliche Issues
-
triage
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
xerial/sqlite-jdbc#1515 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Area/Configuration Type/Improvement
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
ballerina-platform/static-code-analysis-tool#217 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
eclipse-dirigible/dirigible#8636 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug severity-medium XS
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 80/100
nikolas-charalambidis/facepalm-maven-plugin#291 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 62/100
OakLoaf/PluginUpdater#264 ·
Maintainer antworten meist innerhalb von 1 Tag