跳至主要内容
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中自定义模力方舟reranker模型调用报错的问题

解决FastGPT中自定义模力方舟reranker模型调用报错的问题 现象 在FastGPT私有部署V4.12.1版本中，添加自定义模力方舟平台的reranker模型（Qwen3-Reranker-8B、bge-reranker-v2-m3）时，会返回报错信息：{"error":{"code":"400",…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT开发模式下MongoDB认证失败报错问题

解决FastGPT开发模式下MongoDB认证失败报错问题 现象 用户在私有部署FastGPT时，删除了docker-compose.yml文件中的fastgpt部分以及mongo和pg的network-fastgpt配置，单独部署MongoDB与PostgreSQL并初始化副本集为ip:27017。用户f…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT Mongo连接超时且Mongo正常启动的问题

解决FastGPT Mongo连接超时且Mongo正常启动的问题 现象 FastGPT 4.6.9版本启动后，日志显示服务在740ms后进入Ready状态，输出mongo start connect，随后出现Mongo相关报错： 同时Mongo实例的日志显示正常启动流程，包含Updated wire spe…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT中MongoDB查询参数类型校验不足的问题

解决FastGPT中MongoDB查询参数类型校验不足的问题 现象 在使用FastGPT的MongoDB数据库查询相关功能时，可能出现查询结果异常或服务报错的情况。具体表现为部分API接口未对传入参数做严格校验，例如GetDatasetCollectionsProps、UpdateDatasetCollec…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT连接MongoDB密码含未转义字符的报错问题

解决FastGPT连接MongoDB密码含未转义字符的报错问题 现象 启动FastGPT服务时，出现MongoDB连接失败报错，完整错误文本为MongoParseError]: Password contains unescaped characters，同时伴随一系列调用栈信息。 可能原因 该报错由Mon…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT源码运行时MongoDB连接uri未定义的报错问题

解决FastGPT源码运行时MongoDB连接uri未定义的报错问题 现象 运行pnpm dev启动FastGPT源码后，访问http://localhost:3000/ 出现MongoDB连接错误，报错文本为MongooseError: The 'uri' parameter to 'openUri()'…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT出现的MongoDB连接超时与ObjectId转换报错问题

解决FastGPT出现的MongoDB连接超时与ObjectId转换报错问题 现象 在使用或部署FastGPT时，控制台会输出^@error- mongo connect error的报错信息。在执行生成QA的操作时，会触发MongooseError: Operation 'trainingdatas.fi…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.8.1私有部署容器启动时MongoDB无法连接的问题

解决FastGPT 4.8.1私有部署容器启动时MongoDB无法连接的问题 现象 启动FastGPT 4.8.1私有部署容器后，会出现MongoDB无法正常连接的报错。容器的运行日志或前端界面会展示相关连接失败提示，与issue中附的截图表现一致。用户通过重新创建容器并使用-v参数指定数据卷后，发现pro…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT登录时MongoDB数据库连接权限异常问题

解决FastGPT登录时MongoDB数据库连接权限异常问题 现象 用户部署FastGPT后，登录环节出现MongoDB数据库连接权限异常，无法正常建立数据库连接，经初步排查怀疑docker-compose.yml中的MongoDB相关配置存在错误。登录时会弹出数据库连接权限相关的错误提示，具体报错文本需按…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署登录时users.findOne()超时报错的问题

解决FastGPT私有部署登录时users.findOne()超时报错的问题 现象 部署FastGPT 4.6.8私有版本后，访问系统并点击登录时出现报错，报错文本为Operation 'users.findOne() buffering timed out after 10000ms'。用户确认未修改do…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT查询日志接口的MongoDB $lookup参数报错问题

解决FastGPT查询日志接口的MongoDB $lookup参数报错问题 现象 在私有部署版本4.14.4-cve的FastGPT中，调用/api/core/app/logs/list接口查询日志时，系统抛出MongoDB错误。完整报错信息为$lookup with 'pipeline' may not…

2 分钟阅读