LangChain 链路卡住从回调事件找到未结束的步骤LangChain 工作流卡住时总耗时日志几乎帮不上忙。先把 Retriever、Tool、LLM 和 Parser 的开始、结束、错误与取消事件串起来。每一步都有请求标识回调记录组件名称、版本、耗时和结果类型输入只保存脱敏摘要。Tool 调用设置超时流式模型在客户端断开后停止读取。Parser 失败要归类为结构错误不能悄悄返回空对象让下游继续。内存或历史消息也要有容量。Runnable 重试前先判断操作是否幂等否则一次超时可能变成多次写操作。最小复现用固定假模型和假检索器控制正常、延迟、异常与无输出。断言每个开始事件都有结束或取消连接与任务数量回到基线。找到等待点后再修改不要用扩大线程池遮住未完成的 Future。