SSE client silently truncates a data: line at U+2028/U+2029/U+0085, then fails with "Error parsing JSON-RPC message"
還沒有人認領這個 Issue。
評估
- 難度
- 2/5
- 預估耗時
- 1-3 小時
- 新手友好度
- 88/100
- Issue 類型
- 缺陷
- 描述清晰度
- 描述清楚
- 活躍度
- 活躍
- 技術堆疊
- java
- 領域
- networking
研究方向
從 mcp-core/src/main/java/io/modelcontextprotocol/client/transport/ResponseSubscribers.java 開始,追蹤 SseLineSubscriber 對兩個受影響 transport 的 data: 行處理方式。加入 issue 中描述的回歸測試,然後驗證 SseEvent.data() 會保留 U+2028、U+2029 與 U+0085 內容,且不會移除有意義的周圍空白。
由索引模型根據 Issue 內容生成。
描述
Summary
ResponseSubscribers.SseLineSubscriber extracts the payload of an SSE data: line with a MULTILINE regex. Java's MULTILINE mode treats
(LINE SEPARATOR),
(PARAGRAPH SEPARATOR) and
(NEL) as line terminators, so when a data: line contains one of those characters the capture group stops there and everything after it is silently discarded. The client then fails to deserialise the truncated JSON and throws:
io.modelcontextprotocol.spec.McpTransportException: Error parsing JSON-RPC message: SseResponseEvent[...]
Any tool result, resource content or prompt text containing one of these three characters is unreadable by the client. They are legal unescaped inside a JSON string, and they turn up in real content — text pasted from word processors, web pages and PDFs.
Affected code
mcp-core/src/main/java/io/modelcontextprotocol/client/transport/ResponseSubscribers.java:
private static final Pattern EVENT_DATA_PATTERN = Pattern.compile("^data:(.+)$", Pattern.MULTILINE);
private static final Pattern EVENT_ID_PATTERN = Pattern.compile("^id:(.+)$", Pattern.MULTILINE);
private static final Pattern EVENT_TYPE_PATTERN = Pattern.compile("^event:(.+)$", Pattern.MULTILINE);
if (line.startsWith("data:")) {
var matcher = EVENT_DATA_PATTERN.matcher(line);
if (matcher.find()) {
String data = matcher.group(1).trim();
...
this.eventBuilder.append(data).append("\n");
}
upstream().request(1);
}
Two regex properties combine here:
.withoutDOTALLdoes not match\n,\r,,or.$inMULTILINEmode matches before any of those.
So ^data:(.+)$ happily matches a prefix of the line and find() returns true — the truncation is not detectable at the match site.
The line splitter feeding the subscriber (HttpResponse.BodySubscribers.fromLineSubscriber, which uses BufferedReader.readLine() semantics) splits on \n, \r and \r\n only.
/
/
therefore arrive inside a line, where only the regex sees them.
This affects both client transports that use the subscriber: HttpClientStreamableHttpTransport and HttpClientSseClientTransport.
Reproducer
Isolating the regex (JDK 25, but the behaviour is not version-specific):
import java.util.regex.*;
public class SseProbe {
static final Pattern P = Pattern.compile("^data:(.+)$", Pattern.MULTILINE);
static void probe(String name, char c) {
String line = "data:{\"text\":\"" + c + "tail\"}";
Matcher m = P.matcher(line);
String got = m.find() ? m.group(1) : "<no match>";
System.out.printf("%-8s U+%04X line.len=%d captured=%s%n",
name, (int) c, line.length(), got.replace(String.valueOf(c), "<CHAR>"));
}
public static void main(String[] args) {
probe("LS", '
');
probe("PS", '
');
probe("NEL", '
');
probe("VT", '');
probe("plain", 'X');
}
}
LS U+2028 line.len=21 captured={"text":"
PS U+2029 line.len=21 captured={"text":"
NEL U+0085 line.len=21 captured={"text":"
VT U+000B line.len=21 captured={"text":"<CHAR>tail"}
plain U+0058 line.len=21 captured={"text":"<CHAR>tail"}
End to end: have a server return a CallToolResult whose text content contains "a
b", and call it over HttpClientStreamableHttpTransport. The client throws McpTransportException: Error parsing JSON-RPC message instead of returning the result.
Impact in production
We run a gateway that proxies several remote MCP servers. Over the 30 days to 2026-09-18 we logged 179 failed tool calls with this exception, all against one backend (the hosted Atlassian MCP server) — Confluence comment bodies and Jira issue descriptions that contain one of these characters. From the caller's side the tool simply looks broken, and it is reproducible per document: the same tool succeeds on every other page.
Suggested fix
Drop the regexes and strip the field prefix directly, which is also what the SSE spec describes — collect the characters after the colon, removing a single leading U+0020 if present:
if (line.startsWith("data:")) {
String data = line.substring(5);
if (data.startsWith(" ")) {
data = data.substring(1);
}
...
}
Note that the current .trim() on the captured group is lossier than the spec allows in any case: it strips all leading and trailing whitespace rather than the single optional space, so a payload with significant leading/trailing whitespace is also altered.
A regression test wants a data: line containing
and an assertion that the emitted SseEvent.data() is byte-identical to what was written.
Environment
io.modelcontextprotocol.sdk:mcp1.1.0; also present unchanged onmain(2.1.0-SNAPSHOT, checked 2026-09-18)- JDK 25
Possibly of interest to whoever picks this up: #1042 is a separate problem in the same subscriber.
- 主要語言
- Java
- 星號
- 3.7k
- 分支
- 1.1k
- 平均合併
- 1 天 15 小時
- 30 天內合併 PR
- 9
貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
modelcontextprotocol/java-sdk 的其他 Issue
-
area/client bug P2
難度 2/5 1-3 小時 新手友好度 84/100
modelcontextprotocol/java-sdk#1124 · 1 則留言 ·
-
ServerCapabilities.logging is added unconditionally, overriding the caller's explicit capabilities 未關閉bug P2 ready for work
難度 2/5 1-3 小時 新手友好度 68/100
modelcontextprotocol/java-sdk#1086 · 1 則留言 ·
-
enhancement good first issue P3
難度 2/5 1-3 小時 新手友好度 82/100
modelcontextprotocol/java-sdk#1067 ·
-
bug P2 ready for work
難度 2/5 1-3 小時 新手友好度 74/100
modelcontextprotocol/java-sdk#898 · 1 則留言 ·
-
documentation P2
難度 2/5 1-3 小時 新手友好度 65/100
modelcontextprotocol/java-sdk#798 · 1 則留言 ·
查看 modelcontextprotocol/java-sdk 的全部 Issue
相似的 Issue
-
難度 2/5 1-3 小時 新手友好度 82/100
infinispan/infinispan#18150 ·
-
難度 2/5 1-3 小時 新手友好度 84/100
-
untriaged
難度 2/5 1-3 小時 新手友好度 82/100
opensearch-project/k-NN#3597 ·
-
bug
難度 2/5 1-3 小時 新手友好度 88/100
-
bug
難度 2/5 1-3 小時 新手友好度 82/100