ReAct 常见问题排查与调试技巧

引言：为什么很多 ReAct Agent Demo 能跑，上线却翻车？

很多开发者第一次做 ReAct Agent 时，都会经历类似过程：

本地 Demo：非常顺利 线上真实用户：问题不断

常见现象：

• Agent 一直循环不停止
• 工具调用失败
• 明明有工具却不用
• 输出时好时坏，不稳定
• 回答啰嗦、跑偏、胡说
• 同一个问题，这次对，下次错

这并不奇怪。

因为 ReAct Agent 本质是一个动态决策系统：

Thought → Action → Observation → Thought → ...

只要其中任何一环出问题，整体效果就会下降。

所以做 Agent，真正的门槛往往不是“写出来”，而是：

出问题后，你能不能快速定位问题在哪里。

这篇文章，我们专门讲 ReAct Agent 最常见的坑，以及工程上最有效的排查方式。

一、最常见的 6 类问题总览

1. 无限循环

Agent 一直调用工具，不结束。