ExceptionGroup wrapping obscures real errors from task groups

未關閉

#2,114 建立於 2026年2月19日 3 則留言 2 個 reaction 已指派 0 人在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度: 4/5
預估耗時: 3-5 天
新手友好度: 48/100

Issue 類型: 缺陷
描述清晰度: 基本清楚
活躍度: 冷清
技術堆疊: python
領域: backend

研究方向

先閱讀 src/mcp/shared/session.py 和 src/mcp/client/streamable_http.py 中的工作群組處理邏輯，接著檢查 issue 中提到的其他 create_task_group() 位置。重現一個伴隨已取消兄弟工作的連線失敗，並確認真正的例外會在受影響的呼叫點之間傳播，且不會產生取消雜訊。

由索引模型根據 Issue 內容生成。

描述

bug P1 v2

Summary

When SDK internal anyio task group tasks fail, the real error is wrapped in a BaseExceptionGroup alongside Cancelled exceptions from cancelled sibling tasks. This makes error classification extremely difficult for callers — they cannot reliably determine the root cause of a failure.

There are 16 create_task_group() usages across the SDK with no except* syntax or ExceptionGroup unwrapping anywhere.

Expected Behavior

Callers should receive the original exception, not an ExceptionGroup wrapping it alongside cancellation noise
When a task group has one real failure and N cancelled siblings, only the real failure should propagate

Current Behavior

A single connection failure produces a BaseExceptionGroup containing the real error plus multiple Cancelled exceptions
Callers must manually unwrap exception groups to find the root cause
This affects ~80+ call sites across the SDK where task groups are used

Affected Code

src/mcp/shared/session.py (session task groups)
src/mcp/client/streamable_http.py (transport task groups)
All other create_task_group() sites

Related

#1742 — broader typed error classes design
#1830 — CancelledError indistinguishable from external cancellation (closed but related)

_{AI Disclaimer}

主要語言: Python
星號: 24.3k
分支: 4k
平均合併: 1 天 16 小時
30 天內合併 PR: 25

貢獻指南

開啟貢獻指南

從這裡開始

先讀完整個 Issue，再讀專案的貢獻指南。
在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
Fork 儲存庫，在一個分支上完成修改。
送出 Pull Request，並在描述裡引用這個 Issue 編號。

modelcontextprotocol/python-sdk 的其他 Issue

ClientSessionGroup raises KeyError when connecting a server that exposes no components 未關閉

v1 v2

難度 2/5 1-3 小時新手友好度 70/100

modelcontextprotocol/python-sdk#3578 · 1 則留言 · 2026年9月24日建立
func_metadata raises uncaught PydanticSchemaGenerationError for Iterator/AsyncIterator tool return annotations instead of the unstructured fallback 未關閉

v1 v2

難度 2/5 1-3 小時新手友好度 65/100

modelcontextprotocol/python-sdk#3573 · 2 則留言 · 2026年9月23日建立
OAuth client scope handling breaks on comma-separated scope strings 未關閉

v2

難度 2/5 1-3 小時新手友好度 75/100

modelcontextprotocol/python-sdk#3566 · 2026年9月23日建立
Streamable HTTP client logs a WARNING for valid 202 Accepted on session termination (DELETE) 未關閉

v1 v2

難度 2/5 1-3 小時新手友好度 85/100

modelcontextprotocol/python-sdk#3546 · 5 則留言 · 2026年9月19日建立
Server ClientAuthenticator requires client_id in token body, rejecting valid client_secret_basic requests (RFC 6749 §2.3.1) 未關閉

v1 v2

難度 2/5 1-3 小時新手友好度 76/100

modelcontextprotocol/python-sdk#3545 · 2 則留言 · 2026年9月18日建立

查看 modelcontextprotocol/python-sdk 的全部 Issue

相似的 Issue

[Bug] reef-hermes tells me to resume with hermes --resume, which does not work from my shell 未關閉

area: harness bug status: needs-triage

難度 2/5 1-3 小時新手友好度 75/100

Human-Agent-Society/reef#625 · 2026年9月24日建立
Bump transitive axios to >=1.18.0 to address GHSA-hcpx-6fm6-wx23 未關閉

難度 2/5 1-3 小時新手友好度 70/100

coinbase/cdp-sdk#828 · 2026年9月24日建立
AccessibleResourceCard/AccessibleChannelCard crash when a resource has more than one learning activity (getActivityTags returns an object instead of an array) 未關閉

難度 1/5 1 小時以內新手友好度 80/100

learningequality/kolibri#15351 · 2 則留言 · 2026年9月24日建立
audeer.path(): optionally expand environment variables 未關閉

難度 2/5 1-3 小時新手友好度 75/100

audeering/audeer#212 · 1 則留言 · 2026年9月24日建立
Name consistency 未關閉

難度 2/5 1-3 小時新手友好度 75/100

eellak/triplestore#65 · 1 則留言 · 2026年9月24日建立

更多 Python Issue

精選適合新手參與的 GitHub issue 摘要。