Improve exception tracebacks for easier debugging

未關閉

#1,744 建立於 2025年12月5日 1 則留言 0 個 reaction 已指派 0 人在 GitHub 檢視

還沒有人認領這個 Issue。

評估

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

Issue 類型: 功能
描述清晰度: 需要釐清
活躍度: 活躍
技術堆疊: python
領域: backend-api-design

研究方向

該 issue 中未指定任何檔案或測試。先追蹤 asyncio/anyio 工作群組路徑以及 raise_exception 旗標的所有使用位置，然後檢視連結的例外處理相關 issue。完成的條件是：traceback 會揭示使用者層級的失敗、減少 wrapper 巢狀層級，並一致遵循 raise_exception。

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

描述

enhancement P2 v2

Summary

Make exception tracebacks clearer and easier to understand by reducing asyncio/anyio wrapper noise.

Problem

Exceptions are often wrapped in multiple layers of asyncio/anyio task group machinery
Tracebacks are hard to read and don't clearly point to the root cause
The raise_exception flag is not consistently respected
Errors from deep inside task groups obscure the actual failure point

Goal

Cleaner tracebacks that point to user code, not SDK internals
Raise exceptions from the main context where possible
Reduce nesting of exception wrappers

Related

#743 - RuntimeError but the actual root cause is not logged correctly
#396 - MCP Server: Inconsistent Exception Handling in @app.call_tool
#1401 - ClientSession Error Handling
#1742 - Introduce typed error classes with metadata

_{AI Disclaimer}

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

貢獻指南

開啟貢獻指南

從這裡開始

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

modelcontextprotocol/python-sdk 的其他 Issue

OAuth client scope handling breaks on comma-separated scope strings 未關閉

難度 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 · 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日建立

查看 modelcontextprotocol/python-sdk 的全部 Issue

相似的 Issue

PATCH /interviews/{id} 的 goal 字段没有任何长度上限，500KB 字符串直接落库且每次 GET detail 都全量带回未關閉

bug

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

xinnan-tech/xiaozhi-fde-talk#263 · 2026年9月24日建立
rules: REQ-0480 'left fold' jargon is redundant with its own plain restatement 未關閉

rules

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

elong0527/yamaa#978 · 2026年9月24日建立
Validation discards output from runners that report on stderr (jest, unittest) 未關閉

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

huggingface/Repo2RLEnv#163 · 1 則留言 · 2026年9月24日建立
Source link in quantize_embeddings have shifted code highlights 未關閉

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

huggingface/sentence-transformers#4074 · 2026年9月24日建立
Queue insertion button ("插入排队消息") missing in api_server sessions — canInsert allowlist only covers cli/global_agent 未關閉

comp/dashboard invalid P3

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

NousResearch/hermes-agent#121143 · 2026年9月24日建立

更多 Python Issue

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