标签： Python

这个报错发生在 CrewAI 会话式 Flow（conversational Flow）中，当 @listen("...") 的路由标签（route label）与处理器方法名相同时触发。优先排查 @listen 中的字符串参数是否与方法名重复，最简单的临时方案是重命名处理器方法。

该报错通常出现在 Dify 自托管（Docker）环境中，当远程模板服务 tmpl.dify.ai 返回 500 且本地缺少 pipeline_templates.json 文件时触发。优先排查本地容器内 /app/api/constants/pipeline_templates.json 是否存在

这个报错发生在 langchain-perplexity 以 use_responses_api=True 调用 Perplexity 时，请求负载中的消息缺少 type 字段，导致 SDK 的 pydantic 模型无法通过校验。优先检查并修复消息转换逻辑中缺失的 type: "message"

这个报错通常发生在 ComfyUI 更新后，rgthree-comfy 节点显示已加载但面板空白。优先检查是否安装了 ComfyUI_Swwan 等其他自定义节点，因为该节点被确认与 rgthree-comfy 存在代码冲突。

当你用 gradio_client 的 client.submit() 极快地批量提交异步任务给开启了 batch 队列的服务端时，会触发客户端竞态条件，表现为任务在服务端已被处理，但客户端 job.done() 永远不返回 True。优先排查方向是减少提交频率（在循环中插入短暂延迟），这是目前最直