通过应用上下文共享状态
将共享对象传递给每个处理器。
通过应用上下文共享状态 是 CoddyKit 上的免费 MCP Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 MCP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 MCP Academy 课程共包含 4 节课。
每个处理程序都需要的状态
您的工具通常需要相同的对象，例如同一个数据库连接池。您应当只创建一次，然后在各处共享。
yield 的值就是状态
lifespan传出的任何对象都会成为共享的应用状态，可供每个工具、资源和提示使用。
async def lifespan(server):
yield {"db": db, "cache": cache}优先使用类型化容器
将状态封装在数据类中，可以提供清晰的字段名称和编辑器自动补全，而不必猜测字典键。
@dataclass
class AppContext:
db: Database在启动时构建状态
在 lifespan 内部构建每个共享对象，并yield这个容器，使其在整个服务器运行期间持续存在。
async def lifespan(server):
db = await Database.connect()
yield AppContext(db=db)唯一可信来源
共享状态意味着只有一个可信来源：每个处理程序看到的都是同一个连接，因此可以避免创建重复且泄漏的连接池。
不要使用全局变量
不要为连接使用模块级全局变量。通过上下文传递状态可以让工具更易于测试，并避免隐藏的耦合。
状态属于服务器，而非单次调用
应用上下文在启动时创建一次，而不是为每个请求重新构建，因此其中的对象可以跨多次工具调用持续存在。
通过请求访问它
处理程序不会直接导入状态。它们会在调用时接收一个上下文对象，该对象提供对 yield 值的访问。
混合保存连接和配置
共享容器中不只能保存客户端：还可以存放启动时加载的配置，例如 API 基础 URL 或功能开关。
@dataclass
class AppContext:
db: Database
base_url: str尽量保持不可变
请将共享状态视为基本只读。从多个并发调用中修改它，容易引发细微且难以追踪的错误。
由 lifespan 管理整个生命周期
由于 lifespan 创建了状态，因此它也负责销毁状态，使创建和清理始终集中在一个整洁的位置。
快速检查
什么会成为处理程序可以使用的共享应用状态？
回顾：共享状态
您在lifespan中只构建一次共享对象，传出一个类型化容器，然后让每个处理程序读取它。接下来：如何访问它。🧩
用 AI 导师学习 Python — 免费
在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。
- 课程
- 30
- 课程
- 120
常见问题解答
「通过应用上下文共享状态」课时是免费的吗？
是的 — 「通过应用上下文共享状态」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 MCP Academy 课程的其余内容，请升级到 CoddyKit PRO。 MCP Academy 课程共包含 4 节课。
「通过应用上下文共享状态」这节课中我会学到什么？
将共享对象传递给每个处理器。 你通过在浏览器中直接运行的动手代码来练习 MCP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 MCP Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 MCP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「通过应用上下文共享状态」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 MCP Academy 课中编写并运行代码吗？
能。每节 MCP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。