故障排查GitHub Issue
排查FastGPT私有化部署知识库索引状态卡住的问题
排查FastGPT私有化部署知识库索引状态卡住的问题 现象 私有化部署FastGPT 4.9.6版本时，调用知识库OpenAPI批量推送60条文本数据，使用千问text-embedding-v4索引模型。约30%的知识库集合的索引状态卡在「1组索引中」，持续数小时无变化。此时训练状态显示「已就绪」，索引排队…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
解决FastGPT私有部署上传文档时卡在索引步骤的问题
解决FastGPT私有部署上传文档时卡在索引步骤的问题 现象 私有部署FastGPT 4.11.2版本时，上传文档后一直卡在索引步骤。知识库页面显示存在正在训练或重建中的索引，且系统日志中无索引模型调用的痕迹，本地编译FastGPT的过程中未发现其他报错信息。 可能原因 目前无明确已知根因，仅可结合现象梳理…
故障排查GitHub Issue
解决FastGPT私有部署版单知识库测试卡死容器重启问题
解决FastGPT私有部署版单知识库测试卡死容器重启问题 现象 在FastGPT私有部署版v4.9.1-fix2中，测试特定知识库时系统出现卡死情况，其余知识库运行正常；next-server进程资源占用爆满，触发容器自动重启；涉事知识库仅包含73条数据。 可能原因 目前无明确报错文本，结合现象推测可能的原…
故障排查GitHub Issue
解决FastGPT私有部署v4.12.2-fix3的LLM请求偶发竞态报错问题
解决FastGPT私有部署v4.12.2-fix3的LLM请求偶发竞态报错问题 现象 在FastGPT私有部署v4.12.2-fix3版本运行过程中，会偶发出现LLM请求报错问题。该问题发生时，系统同时存在模型更新日志，且期间未对模型配置进行过任何变更。 可能原因 模型更新时的执行流程为：清空全局模型→异步…
故障排查GitHub Issue
解决FastGPT私有部署4.8.3版对话日志被非授权删除的问题
解决FastGPT私有部署4.8.3版对话日志被非授权删除的问题 现象 在FastGPT私有部署4.8.3版本中，出现两处异常表现：一是删除对话内容后，该对话关联的日志会随之消失；二是未经过身份验证的用户，也可以执行对话删除操作，篡改日志数据，不符合预期的日志保护逻辑。 可能原因 该问题的核心原因是Fast…
故障排查GitHub Issue
FastGPT私有部署登录时报MongoDB连接错误的排查方法
FastGPT私有部署登录时报MongoDB连接错误的排查方法 现象 使用FastGPT私有部署4.8.3版本时，使用默认账号密码root/1234登录失败。后台日志显示编译了/api/support/user/account/loginByPassword接口后，抛出MongooseServerSelec…
故障排查GitHub Issue
解决FastGPT 4.8.4私有部署版本本地Mongo连接报错问题
解决FastGPT 4.8.4私有部署版本本地Mongo连接报错问题 现象 FastGPT 4.8.4私有部署版本通过Docker运行正常，知识库问答功能可正常使用。在本地开发过程中出现Mongo数据库连接报错；使用Mongo Compass测试连接Mongo容器时同样报错，对应Mongo容器日志生成了相关…
故障排查GitHub Issue
FastGPT 4.6私有部署版MongoDB数据库迁移指南
FastGPT 4.6私有部署版MongoDB数据库迁移指南 现象 FastGPT 4.6私有部署版本在跨环境迁移时，缺乏官方的MongoDB数据库迁移指引，多名用户包括部署者在内多次尝试迁移均失败。 可能原因 1. 项目未提供官方MongoDB数据库迁移文档； 2. 原环境与目标环境的MongoDB容器持…
故障排查GitHub Issue
FastGPT 4.6.8私有部署MongoDB无法启动的排查与解决
FastGPT 4.6.8私有部署MongoDB无法启动的排查与解决 现象 按照官方Docker部署文档部署FastGPT 4.6.8私有版本，完成部署第四步后MongoDB无法启动。用户使用未做任何修改的默认配置文件，其粘贴的配置文件最后一行仅为"toolChoic，存在JSON格式不完整的问题。 可能原…
故障排查GitHub Issue
解决FastGPT私有部署时MongoDB访问被拒无法启动的问题
解决FastGPT私有部署时MongoDB访问被拒无法启动的问题 现象 用户在Win10系统（Docker Desktop v4.30.0）中，使用最新版FastGPT的docker-compose.yml文件，将镜像源替换为阿里云后，修改了PG的权限配置，执行docker compose up -d启动容…
故障排查GitHub Issue
解决FastGPT私有部署版工作流嵌套选择操作无回复问题
解决FastGPT私有部署版工作流嵌套选择操作无回复问题 现象 私有部署版本4.8.22的FastGPT中，封装了用户确认选择操作的工作流，无法通过嵌套调用的方式在其他工作流中正常输出指定回复内容。具体表现为：在单个工作流内测试用户选择操作时，可正常输出预设的指定回复；但将该工作流嵌套至另一个工作流后，点击…
故障排查GitHub Issue
解决FastGPT私有部署版Ollama工具调用失败问题
解决FastGPT私有部署版Ollama工具调用失败问题 现象 用户使用FastGPT 4.8.17私有部署版，搭配Ollama 0.5.4、OneAPI 0.6.7部署Qwen2.5:14b模型后，通过curl直接调用OneAPI的工具接口无报错，但在FastGPT工作流中无法正常使用工具调用。用户提供了…