快速结论:当 Flow 子类以 `initial_state = S()`(FlowState 实例)方式设置初始状态时,每次实例化都会复用类定义时生成的同一个 `state.id`,导致多次运行共享同一个 `flow_id`。优先排查 `Flow._create_initial_state` 中对 `id` 是否重新生成的处理。
适用环境:macOS Catalina;Python 3.12;crewAI 1.15.41;crewAI Tools 1.15.41;Venv 虚拟环境。
最快修复方案:暂无确认的一步修复方案。Issue 中提出的修改思路(在 `_create_initial_state` 中仅当 `”id” not in model.model_fields_set` 时才重新生成 id)尚未合并,属于可优先尝试的方向。
注意事项:该修复思路仅经代码阅读验证,未在本机运行验证;需要在 `model_dump()` 得到的字典上重新生成 id,再传入 `model_class(**state_dict)`,不要原地修改共享的 `initial_state` 实例,否则会影响所有 Flow 实例。
问题场景
使用 CrewAI 的 Flow 时,定义了一个继承自 `FlowState` 的状态类 `S`,并在 Flow 子类中通过 `initial_state = S()` 指定初始状态。创建两个 Flow 实例 `a, b = F(), F()` 后发现 `a.state.id` 与 `b.state.id` 相同。配合 `@persist(SQLiteFlowPersistence(…))` 时,不同输入两次 kickoff(启动)的结果会被保存在同一 `flow_uuid` 下,`load_state(flow_id)` 只能返回最后一次保存的状态。
报错原文
[BUG] initial_state = FlowState() gives every Flow instance the same state.id
a, b = F(), F()
print(a.state.id, b.state.id, a.state.id == b.state.id)
# prints the same id twice and True
原因分析
最可能的原因是:`FlowState.id` 定义为 `Field(default_factory=lambda: str(uuid4()))`,因此 `S()` 在类定义时就已经生成了一个固定 id。`Flow._create_initial_state` 中 `isinstance(init_state, BaseModel)` 分支先执行 `state_dict = model.model_dump()`,仅在 `if not state_dict.get(“id”)` 时重新生成 id;而 `FlowState()` 实例的 id 始终为真值,所以每个 `F()` 都通过 `model_class(**state_dict)` 复用了同一个 id。
作为对照,`initial_state = S`(传入类而非实例)走 `type` 分支,会为每个 Flow 重新构造 `state_class()`,因此能得到新 id;dict 分支虽有不同的守卫写法,但也不会出现该问题。实例分支是唯一异常的分支。
环境排查
- 确认 crewAI 版本是否为 1.15.41 或受影响的相近版本。
- 确认 crewAI Tools 版本(Issue 中为 1.15.41)。
- 确认 Python 版本(Issue 中为 3.12)。
- 确认是否使用 Venv 虚拟环境。
- 检查 Flow 是否以 `initial_state = S()` 实例形式设置,而非 `initial_state = S` 类形式。
- 检查是否启用了 `@persist` 持久化,并观察 `flow_states` 表中 `flow_uuid` 的分布。
解决步骤
- 先最小复现:定义 `class S(FlowState)` 与 `class F(Flow[S]): initial_state = S()`,创建两个实例并比较 `state.id`,确认是否相等。
- 临时规避:将 `initial_state = S()` 改为 `initial_state = S`(传类不传实例),使每个 Flow 构造全新的状态对象并获得新 id。
- 若必须使用实例形式:在创建 Flow 前显式传入不同 id,如 `S(id=”fixed”)` 只适用于确实需要固定 id 的场景;不要指望默认实例能自动获得唯一 id。
- 若自行修复代码:在 `_create_initial_state` 的 BaseModel 分支中,依据 `”id” not in model.model_fields_set` 判断用户是否显式设置 id;未显式设置时在 `model_dump()` 得到的 `state_dict` 上写入新 id,再执行 `model_class(**state_dict)`。
- 补充回归测试:覆盖 `S()` 两个实例 id 不同、`S(id=”fixed”)` 保留固定 id、以及 `@persist` 下不同输入写入不同 `flow_uuid` 三种情况。
验证方法
重新执行复现片段,确认 `a.state.id` 与 `b.state.id` 不再相同,且 `a.state.id == b.state.id` 输出 `False`;再用 `@persist(SQLiteFlowPersistence(…))` 以不同输入执行两次 kickoff,检查 `flow_states` 表中是否出现两个不同的 `flow_uuid`,并确认 `load_state(flow_id)` 能分别取回对应运行的状态。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


