故障排查GitHub Issue
解决FastGPT中非首块表格无法正确映射表头的问题
解决FastGPT中非首块表格无法正确映射表头的问题 现象 使用FastGPT处理表格数据时，首个数据块可正常关联表头，第二个及之后的数据块无法正确匹配对应表头，检索非首块数据时出现映射异常。 可能原因 原有处理逻辑仅针对首个数据块配置表头映射规则，非首块数据未关联表头映射逻辑；同时原有逻辑对csv、exc…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
解决FastGPT非Host模式Docker部署数据库连接失败问题
解决FastGPT非Host模式Docker部署数据库连接失败问题 现象 使用非Host模式（不使用本机代理）的Docker部署FastGPT，重新拉取最新docker-compose.yml后出现数据库连接失败问题。使用旧版本docker-compose.yml可正常运行部署，同时需确认FastGPT当前…
故障排查GitHub Issue
FastGPT 4.14.5-fix 偶发对话记录缺失的历史排查
FastGPT 4.14.5-fix 偶发对话记录缺失的历史排查 适用场景与历史记录 原报告称旧版和 4.14.5-fix 曾各发现一次少量对话记录缺失，应用日志中也查不到对应记录。 原始讨论提交于 2026-01-21，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 原线程缺少根因与恢复确认。…
故障排查GitHub Issue
解决FastGPT中OceanBase向量索引重复创建报错的问题
解决FastGPT中OceanBase向量索引重复创建报错的问题 现象 在packages/service/common/vectorDB/oceanbase/index.ts文件中，执行await ObClient.query的如下语句时，每次重启应用都会执行该语句： CREATE VECTOR INDE…
故障排查GitHub Issue
解决FastGPT私有化部署后断网访问界面无响应的问题
解决FastGPT私有化部署后断网访问界面无响应的问题 现象 私有化部署FastGPT V4.8.3时，联网状态下可正常使用所有功能。断网后，访问localhost:3000出现界面无响应的情况。通过浏览器开发者工具查看网络请求，可发现访问首页时会发起指向https://api.github.com/rep…
故障排查GitHub Issue
FastGPT 离线或内网部署页面无响应问题排错
FastGPT 离线或内网部署页面无响应问题排错 现象 私有化部署后，断网或内网环境下访问页面无响应。浏览器开发者工具显示页面请求了https://api.github.com/repos/labring/FastGPT，该请求无法完成导致访问失败。部分用户配置showgit后仍出现配置不生效的情况，同时存…
故障排查GitHub Issue
解决FastGPT部署后断网导致页面与创建操作加载异常的问题
解决FastGPT部署后断网导致页面与创建操作加载异常的问题 现象 完成FastGPT部署，获取所需的docker-compose.yml与配置文件后，通过docker compose up -d命令启动成功。断开主机网络连接，访问localhost:3000时页面加载失败，创建应用或知识库的操作持续处于加…
故障排查GitHub Issue
解决FastGPT集成开源离线私有LLM与embedding模型的部署问题
解决FastGPT集成开源离线私有LLM与embedding模型的部署问题 现象 在FastGPT中尝试集成更多开源离线私有LLM模型和embedding模型，并通过docker镜像部署时，无法实现预期的模型集成效果。按照现有流程配置后，模型无法正常加载或调用，业务流程无法正常运行。 可能原因 FastGP…
故障排查GitHub Issue
FastGPT配置Ollama时找不到配置入口的排障方法
FastGPT配置Ollama时找不到配置入口的排障方法 现象 在FastGPT中配置Ollama服务时，无法找到对应的配置入口，无法完成配置流程；部分场景下完成配置后，配合数据库运行速度较慢。 可能原因 无法找到配置入口的原因可能为未定位到FastGPT内置的Ollama配置模块；配置后运行速度较慢的原因…
故障排查GitHub Issue
解决FastGPT部署Ollama时的LLM模型响应为空报错
解决FastGPT部署Ollama时的LLM模型响应为空报错 现象 私有部署FastGPT 4.9.0版本，已确认使用的密钥可正常使用。本地部署OLLAMA并完成LLM、嵌入模型的配置且通过测试后，新建对话应用时出现chat:LLMModelResponseEmpty报错。 可能原因 当前版本不支持OLLA…
故障排查GitHub Issue
解决FastGPT结合Ollama的常见问题
解决FastGPT结合Ollama的常见问题 现象 使用FastGPT搭配Ollama部署的模型时，存在三类常见异常。第一类为引用知识库内容后回答未达预期，单独向模型询问问答与参考信息时结果正常。第二类为知识库中的图片无法在FastGPT输出中展示，使用其他方式加载模型时可正常展示图片。第三类为知识库检索异…
故障排查GitHub Issue
解决FastGPT无法正常使用需接入one api的问题
解决FastGPT无法正常使用需接入one api的问题 现象 使用FastGPT时无法实现预期功能，未明确具体报错文本，相关细节需按实际环境确认。 可能原因 未完成one api的接入配置，导致功能无法正常实现。 排查步骤 1. 确认当前使用的FastGPT部署类型。 2. 核对已配置的密钥是否可正常使用…