跳至主要内容
FASTGPT / 技术中心

从部署到 API，
直接找到可执行答案。

面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。

4244 篇内容11 个主题官方文档与公开 Issue
推荐入口
API官方文档3 分钟阅读

FastGPT对话接口API的调用方法与参数配置说明

可在应用详情的路径中获取AppId。鉴权使用APIKey，支持两种方式：调用 chat/completions 时在请求体传入 body.appId ，或通过 Authorization: Bearer apiKey - a…

阅读 API 指南 查看官方文档

按任务找到答案

共 4244 篇

故障排查GitHub Issue

解决FastGPT私有部署版本上传文件无法删除的问题

解决FastGPT私有部署版本上传文件无法删除的问题 现象 用户使用FastGPT 4.6.8私有部署版本，GPT系列LLM的调用功能正常，在调测GLM期间，出现上传的文件无法删除的问题。 可能原因 目前无明确已知触发原因，需结合实际部署环境、存储配置、权限设置等维度逐一排查，具体细节需按实际环境确认。 排…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署v4.9.7-fix2的内存GC报错问题

解决FastGPT私有部署v4.9.7-fix2的内存GC报错问题 现象 FastGPT私有部署v4.9.7-fix2版本运行时，系统日志出现V8引擎垃圾回收相关报错，具体报错日志如下： 同时附带内存相关的截图记录。 可能原因 该报错为V8引擎垃圾回收任务失败的提示，从日志参数来看，当前进程内存占用接近40…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT v4.8.22私有部署版分块后图片丢失问题

解决FastGPT v4.8.22私有部署版分块后图片丢失问题 现象 使用FastGPT v4.8.22私有部署版本时，上传带大量图片的文件首次存储正常。调整训练参数后重新分块，图片出现expiredTime标识，超时后图片被删除，再次在知识库中查看时图片丢失。小文件不会出现该问题。 可能原因 暂未明确具体…

2 分钟阅读
故障排查GitHub Issue

排查FastGPT私有化部署知识库索引状态卡住的问题

排查FastGPT私有化部署知识库索引状态卡住的问题 现象 私有化部署FastGPT 4.9.6版本时，调用知识库OpenAPI批量推送60条文本数据，使用千问text-embedding-v4索引模型。约30%的知识库集合的索引状态卡在「1组索引中」，持续数小时无变化。此时训练状态显示「已就绪」，索引排队…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署上传文档时卡在索引步骤的问题

解决FastGPT私有部署上传文档时卡在索引步骤的问题 现象 私有部署FastGPT 4.11.2版本时，上传文档后一直卡在索引步骤。知识库页面显示存在正在训练或重建中的索引，且系统日志中无索引模型调用的痕迹，本地编译FastGPT的过程中未发现其他报错信息。 可能原因 目前无明确已知根因，仅可结合现象梳理…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版单知识库测试卡死容器重启问题

解决FastGPT私有部署版单知识库测试卡死容器重启问题 现象 在FastGPT私有部署版v4.9.1-fix2中，测试特定知识库时系统出现卡死情况，其余知识库运行正常；next-server进程资源占用爆满，触发容器自动重启；涉事知识库仅包含73条数据。 可能原因 目前无明确报错文本，结合现象推测可能的原…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署v4.12.2-fix3的LLM请求偶发竞态报错问题

解决FastGPT私有部署v4.12.2-fix3的LLM请求偶发竞态报错问题 现象 在FastGPT私有部署v4.12.2-fix3版本运行过程中，会偶发出现LLM请求报错问题。该问题发生时，系统同时存在模型更新日志，且期间未对模型配置进行过任何变更。 可能原因 模型更新时的执行流程为：清空全局模型→异步…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署4.8.3版对话日志被非授权删除的问题

解决FastGPT私有部署4.8.3版对话日志被非授权删除的问题 现象 在FastGPT私有部署4.8.3版本中，出现两处异常表现：一是删除对话内容后，该对话关联的日志会随之消失；二是未经过身份验证的用户，也可以执行对话删除操作，篡改日志数据，不符合预期的日志保护逻辑。 可能原因 该问题的核心原因是Fast…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署登录时报MongoDB连接错误的排查方法

FastGPT私有部署登录时报MongoDB连接错误的排查方法 现象 使用FastGPT私有部署4.8.3版本时，使用默认账号密码root/1234登录失败。后台日志显示编译了/api/support/user/account/loginByPassword接口后，抛出MongooseServerSelec…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.8.4私有部署版本本地Mongo连接报错问题

解决FastGPT 4.8.4私有部署版本本地Mongo连接报错问题 现象 FastGPT 4.8.4私有部署版本通过Docker运行正常，知识库问答功能可正常使用。在本地开发过程中出现Mongo数据库连接报错；使用Mongo Compass测试连接Mongo容器时同样报错，对应Mongo容器日志生成了相关…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.6私有部署版MongoDB数据库迁移指南

FastGPT 4.6私有部署版MongoDB数据库迁移指南 现象 FastGPT 4.6私有部署版本在跨环境迁移时，缺乏官方的MongoDB数据库迁移指引，多名用户包括部署者在内多次尝试迁移均失败。 可能原因 1. 项目未提供官方MongoDB数据库迁移文档； 2. 原环境与目标环境的MongoDB容器持…

3 分钟阅读
故障排查GitHub Issue

FastGPT 4.6.8私有部署MongoDB无法启动的排查与解决

FastGPT 4.6.8私有部署MongoDB无法启动的排查与解决 现象 按照官方Docker部署文档部署FastGPT 4.6.8私有版本，完成部署第四步后MongoDB无法启动。用户使用未做任何修改的默认配置文件，其粘贴的配置文件最后一行仅为"toolChoic，存在JSON格式不完整的问题。 可能原…

2 分钟阅读