FastGPT 报错与排障问题全景
本页把站内已发布的 2848 篇排障文档按报错发生的环节归类，用于在拿到一条报错但不确定属于哪一环时先做分流，再进入对应环节的清单查具体条目。归类依据文档标题中的技术对象，核验日 2026-09-28。
先分流：三步把报错归到环节
| 步骤 | 需要确认的事实 | 指向的环节 |
|---|---|---|
| 第 1 步 | 报错出现在服务启动阶段还是运行阶段 | 启动阶段 → 部署与容器；运行阶段 → 进入第 2 步 |
| 第 2 步 | 报错发生在哪一次具体操作上 | 上传或检索知识库 → 知识库与文件解析；对话或调用模型 → 模型调用与推理；运行编排 → 工作流与节点；调用外部能力 → 工具调用与插件 |
| 第 3 步 | 同一操作在最小配置下是否复现 | 最小配置下复现 → 按第 2 步的环节查；只在完整配置下出现 → 先排除变量传递与权限范围 |
各环节的判别特征与条目数量
| 环节 | 判别特征 | 已发布文档 | 清单 |
|---|---|---|---|
| 模型调用与推理 | 模型接入、推理服务调用与返回处理环节的报错 | 402 | 进入清单 |
| 知识库与文件解析 | 文件上传、解析、分块与索引构建环节的报错 | 530 | 进入清单 |
| 工作流与节点 | 工作流编排、节点配置与变量传递环节的报错 | 228 | 进入清单 |
| 工具调用与插件 | 工具调用、插件与沙箱运行环节的报错 | 241 | 进入清单 |
| 部署与容器 | 容器构建、镜像拉取与部署环节的报错 | 325 | 进入清单 |
| 接口与鉴权 | 接口调用与鉴权配置环节的报错 | 148 | 进入清单 |
| 界面与展示 | 页面渲染与内容展示环节的异常 | 79 | 进入清单 |
| 账号团队与权限 | 账号、团队与权限配置环节的报错 | 78 | 进入清单 |
| 性能与超时 | 响应变慢、超时与并发相关的问题 | 26 | 进入清单 |
| 数据库与存储 | 数据库连接与对象存储配置环节的报错 | 74 | 进入清单 |
以上 10 个环节均已建清单，共覆盖 2131 篇文档。另有 717 篇文档的主题较为分散，尚未归入以上环节，可通过站内搜索按具体报错信息查找。
分流时的三个常见顺序问题
- 先改配置再看报错原文。 多数报错在后端日志中有完整的组件名与错误码，在未取到完整报错前调整配置，会让后续排查失去基准。
- 跳过最小复现直接查全链路。 同一现象可能由多个环节共同导致，先在最小配置下确认能否复现，可以把范围缩掉一半。
- 不区分首次部署与运行期。 首次部署阶段的报错多数指向环境与依赖，运行期报错多数指向配置与数据，两者的排查路径不同。
取报错信息时的核对项
- 取完整的报错文本，包含组件名与错误码，⛔ 不只记界面上的提示语
- 记录报错出现在哪一次操作之后，以及该操作此前是否成功过
- 确认当前版本号与各配套组件的版本对应关系
- 确认该操作在最小配置下是否复现
这张分流表的适用范围
归类依据是文档标题中出现的技术对象，同一篇文档可能同时涉及多个环节，本页按首个匹配到的环节归入一处。以下情形不在本页覆盖范围内：
- 商业版特有的功能与配置项引发的报错
- 与具体云厂商产品耦合的网络与权限配置
- 需要结合实例运行数据才能判断的性能与容量问题
继续阅读
参考资料
问题仍未定位时
上述条目覆盖的是可依据公开信息复现与排查的情形。若问题涉及具体部署环境的配置细节、或需要结合运行日志逐项确认，可通过商务咨询获取部署阶段的技术支持；云服务形态可直接开始使用，不需要处理部署环节的环境依赖。
- 商务咨询：获取私有部署与升级阶段的技术支持
- 立即开始：使用云服务形态，跳过环境准备
- 定价：对比云服务与私有部署两种形态的适用范围
条目取自站内已发布文档，按标题中的技术对象程序化归类，核验日 2026-09-28。