ExceptionGroup wrapping obscures real errors from task groups

オープン

#2,114 2026年2月19日に作成コメント 3 件リアクション 2 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 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

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

_{AI Disclaimer}

主要言語: Python
スター: 24.3k
フォーク: 4k
平均マージ: 1日 19分
マージ済み PR（30日）: 29

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
issue 番号を参照したプルリクエストを送ります。

modelcontextprotocol/python-sdk のほかの issue

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 · コメント 1 件 · 2026年9月18日に作成
Revocation requires client_secret to be present オープン

v1 v2

難易度 1/5 1時間未満初心者へのやさしさ 91/100

modelcontextprotocol/python-sdk#3508 · コメント 2 件 · 2026年9月15日に作成
Does same-origin redirect enforcement break MCP servers behind a reverse proxy? オープン

難易度 2/5 1〜3時間初心者へのやさしさ 64/100

modelcontextprotocol/python-sdk#3504 · 2026年9月15日に作成
Streamable HTTP stateless servers hang clients on the listen-mode GET (_handle_get_request opens a hold-open SSE stream) オープン

v1 v2

難易度 2/5 1〜3時間初心者へのやさしさ 82/100

modelcontextprotocol/python-sdk#3492 · コメント 1 件 · 2026年9月11日に作成

modelcontextprotocol/python-sdk の issue をすべて見る

似ている issue

[Bug] 发布机 Chrome applet 1.3 打开双语 Web 资产变英文（zh-hans 语言码不命中 zh-CN）オープン

🐛 Bug 🔔 Pending processing

難易度 2/5 1〜3時間初心者へのやさしさ 84/100

jumpserver/jumpserver#17584 · 2026年9月21日に作成
Sphinx ScyllaDB Theme: 1 broken link オープン

link-check link-check:sphinx-theme

難易度 2/5 1〜3時間初心者へのやさしさ 72/100

scylladb/scylladb-docs-homepage#274 · 2026年9月21日に作成
[Bug] Qwen-Image-2.1 validate_full 未加载训练权重，实际验证的是基座模型オープン

難易度 2/5 1〜3時間初心者へのやさしさ 90/100

modelscope/DiffSynth-Studio#1702 · 2026年9月21日に作成
[feature][processing] Add profile selection options to qgis_process (Request in QGIS) オープン

難易度 2/5 1〜3時間初心者へのやさしさ 65/100

qgis/QGIS-Documentation#11275 · 2026年9月21日に作成
fix(automation): do not restart an active subject delivery オープン

bug priority:normal ready-for-dev

難易度 2/5 1〜3時間初心者へのやさしさ 88/100

OpenHands/extensions#626 · コメント 1 件 · 2026年9月21日に作成

Python の issue をもっと見る