testcontainers / testcontainers/testcontainers-java

[Bug]: getFirstMappedPort returns wrong port after adding secondary network

Offen
#11,779 2 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

type/bug
Vorherrschende Sprache
Java
Sterne
8.7k
Forks
1.9k
Ø Merge
2 T. 17 Std.
Gemergte PRs (30 T.)
9

Beschreibung

Module

Core

Testcontainers version

1.21.4

Using the latest Testcontainers version?

Yes

Host OS

Linux

Host Arch

x86

Docker version
Version:           29.4.3
 API version:       1.54
 Go version:        go1.26.2
 Git commit:        055a478
 Built:             Wed May  6 17:07:39 2026
 OS/Arch:           linux/amd64
 Context:           default

Server: Docker Engine - Community
 Engine:
  Version:          29.4.3
  API version:      1.54 (minimum version 1.41)
  Go version:       go1.26.2
  Git commit:       56be731
  Built:            Wed May  6 17:07:39 2026
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          v2.2.3
  GitCommit:        77c84241c7cbdd9b4eca2591793e3d4f4317c590
 runc:
  Version:          1.3.5
  GitCommit:        v1.3.5-0-g488fc13e
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0
What happened?

I configure a container like so :

Network defaultNetwork = new Network();
Network customNetwork = return new Network() {
				public String getId() { return cystomNetworkId; }
				public void close() {}
				public Statement apply(Statement base, Description description) { return null; }
			};

GenericContainer container = new GenericContainer<>(DockerImageName.parse("registry.ogosecurity.com/repository/ogo/traefik-ogo-proxy:latest"))
					.withNetwork(customNetwork)
					.withNetworkAliases("test-host")
					.withExposedPorts(7077);
container.start();
dockerClient.connectToNetworkCmd()
					.withContainerId(container.getContainerId())
					.withNetworkId(defaultNetwork.getId())
					.exec();

Then, when I ask the mapped port with container.getFirstMappedPort(), the returned port is not usable. docker ps shows a mapped port which is +1 compared to getFirstMappedPort().
It looks like adding a network remaps the exposed port, but testcontainer somewhat cached the first value.
Starting with defaultNetwork and then adding my customNetwork fixes the issue for me regarding the port (I can connect from the host using the given port), but then I can't use the network alias from another container the customNetwork.

Relevant log output

Additional Information

No response

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne mit GenericContainer.withNetwork und getFirstMappedPort und reproduziere anschließend die bereitgestellte Konfiguration mithilfe von connectToNetworkCmd. Vergleiche den zurückgegebenen Port mit docker ps. Verfolge, wann das Port-Mapping im Verhältnis zum Hinzufügen des sekundären Netzwerks abgerufen wird. Als abgeschlossen gilt die Aufgabe, wenn getFirstMappedPort den nutzbaren Host-Port zurückgibt, nachdem der Container mit beiden Netzwerken verbunden wurde, und ein Regressionstest das network-alias-Szenario abdeckt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
docker, java
Bereich
networking, testing
Issue-Typ
Bug
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Ruhig
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
48/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.