StdioClientTransport: Inbound Scheduler and Error Scheduler threads are locked on Windows

Offen

#759 erstellt am 26.1.2026 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 4/5
Geschätzter Aufwand: 3-5 Tage
Anfängerfreundlichkeit: 38/100

Issue-Typ: Bug
Klarheit: Größtenteils klar
Aktivitätsstatus: Veraltet
Tech-Stack: java
Bereich: backend

Rechercherichtung

Beginne bei io.modelcontextprotocol.client.transport.StdioClientTransport, mit Fokus auf den Inbound Scheduler, den Error Scheduler und die closeGracefully-Methode, und prüfe dann den beigefügten Windows-Thread-Dump auf blockierte Lesevorgänge. Reproduziere die Spring AI Filesystem Demo unter Windows und verifiziere, dass das Herunterfahren den Java-Prozess beendet, ohne Scheduler-Threads gesperrt zu hinterlassen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

bug P2

Bug description
Two threads, Inbound Scheduler and Error Scheduler, remain locked forever (at java.io.FileInputStream.readBytes native call) in io.modelcontextprotocol.client.transport.StdioClientTransport after the graceful shutdown is completed using closeGracefully method.

Looks like a Windows specific issue with native I/O calls. The problem is observed when running on Windows. No problems with Linux environment.

The thread dump is attached.
dump_jdk17.txt
See "pool-2-thread-1" and "pool-5-thread-1" dumps.

Environment
Windows 11 Enterprise
mcp-core 0.17.1
Spring AI 2.0.0-SNAPSHOT
JDK Temurin 17.0.14 (also tried Amazon Corretto 21.0.5)

Linux Behavior
Works fine under Ubuntu 24.04 and JDK Temurin 21.0.10

Steps to reproduce

Run the steps from the Spring AI Filesystem Demo example on Windows.
The Java application process is not terminated as expected.

Expected behavior
The Java process terminates after running the Spring AI Filesystem Demo example.

Possible solution
On Windows, use daemon threads for inbound and error schedulers

private ThreadFactory daemonThreadFactory = runnable -> {
		Thread t = new Thread(runnable);
		t.setDaemon(true);
		return t;
	};

if (isWindows) {
    this.inboundScheduler = Schedulers.fromExecutorService(Executors.newSingleThreadExecutor(daemonThreadFactory), "inbound");
    this.errorScheduler = Schedulers.fromExecutorService(Executors.newSingleThreadExecutor(daemonThreadFactory), "error");
}

Tried this solution locally. It resolves the termination issue. But the graceful shutdown logic in io.modelcontextprotocol.client.transport.StdioClientTransport#closeGracefully should be revised as well.

Vorherrschende Sprache: Java
Sterne: 3.7k
Forks: 1.1k
Ø Merge: 1 T. 15 Std.
Gemergte PRs (30 T.): 9

Beitragsleitfaden

Beitragsleitfaden öffnen

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 modelcontextprotocol/java-sdk

SSE client silently truncates a data: line at U+2028/U+2029/U+0085, then fails with "Error parsing JSON-RPC message" Offen

area/transport bug P2

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 88/100

modelcontextprotocol/java-sdk#1136 · Erstellt am 18.9.2026
Client request handlers that complete empty send no JSON-RPC response Offen

area/client bug P2

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 84/100

modelcontextprotocol/java-sdk#1124 · 1 Kommentar · Erstellt am 03.9.2026
ServerCapabilities.logging is added unconditionally, overriding the caller's explicit capabilities Offen

bug P2 ready for work

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100

modelcontextprotocol/java-sdk#1086 · 1 Kommentar · Erstellt am 11.8.2026
Reject listRoots if not supported by client, without sending any request Offen

enhancement good first issue P3

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100

modelcontextprotocol/java-sdk#1067 · Erstellt am 19.7.2026
StdioClientTransport missing explicit UTF-8 charset in InputStreamReader (same issue as #295, but on client side) Offen

bug P2 ready for work

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 74/100

modelcontextprotocol/java-sdk#898 · 1 Kommentar · Erstellt am 02.4.2026

Alle Issues in modelcontextprotocol/java-sdk