LangGraph流式输出失效问题解决

0 前言

最近在学习使用LangGraph搭建智能体，在学习到流式输出部分时始终做不出效果，总是完整回复一大块，后面发现了一篇宝藏文章，才知道原来是python版本的问题。

1 官网原文

LangGraph官网原文链接

翻译：
Async with Python < 3.11

在Python版本低于3.11时，异步任务不支持上下文参数。这限制了LangGraph自动传播上下文的能力，并以两种关键方式影响LangGraph的流式处理机制：

• 你必须显式地将RunnableConfig传递给异步LLM调用（例如，通过ainvoke()），因为回调不会自动传播。
• 在异步节点或工具中无法使用get_stream_writer——必须直接传递writer参数。

2 解决方式

方法很简单就是替换项目的python版本，我这里是使用uv管理的项目

1. 把.python-version中python版本设置为3.12
2. 在pyproject.toml中设置requires-python = ">=3.12"
3. 在uv.lock中设置requires-python = ">=3.12"
4. 重新删除虚拟环境）rm -rf .venv
5. 重建虚拟环境uv venv
6. 安装依赖并验证版本uv run python --version

3 效果

此时已能正常流式输出

宝藏文章链接