故障排查GitHub Issue
FastGPT多轮对话接口调用参数选择与使用说明
FastGPT多轮对话接口调用参数选择与使用说明 现象 用户基于FastGPT开发应用并对接前端时，对多轮对话的接口传参方式存在疑问。用户发起第一轮对话时传入chatId为9999、单条用户消息“你好”，在第二轮对话时，不确定是仅传入当前用户消息“我刚刚问了啥”与chatId9999，还是需要传入包含完整历…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
FastGPT多模态API传入base64图片报错的排查与解决方法
FastGPT多模态API传入base64图片报错的排查与解决方法 现象 使用FastGPT的多模态模型应用开放API访问时，传入base64格式图片发起请求，会返回如下报错： 可能原因 根据报错信息，问题源于FastGPT识别传入的图片数据为无效URL。可能的原因包括：传入的base64图片未按照标准da…
故障排查GitHub Issue
解决FastGPT多模态API图文关联丢失与assistant消息过滤问题
解决FastGPT多模态API图文关联丢失与assistant消息过滤问题 现象 用户调用FastGPT多模态API时，若通过content有序数组格式传输图文混合消息，FastGPT内部会自动将所有图片资源前置，并将数组内所有文本内容合并为单一段落，导致图文关联丢失。同时，消息体中的assistant角色…
故障排查GitHub Issue
解决FastGPT中添加多个ECharts配置引发页面崩溃的问题
解决FastGPT中添加多个ECharts配置引发页面崩溃的问题 现象 在FastGPT平台中，当添加超过三个ECharts可视化配置时，会触发页面崩溃问题。具体表现为完成第三个ECharts配置的添加后，页面无法正常加载或直接无响应。本次用户测试的三个配置分别为时间趋势图、平台对比图、地域分布图的ECha…
故障排查GitHub Issue
解决FastGPT多线程使用同一API key访问应用报错问题
解决FastGPT多线程使用同一API key访问应用报错问题 现象 多线程使用同一个API key同时访问FastGPT应用时，应用出现报错。直接使用相同程序访问大模型原生接口，返回结果正常。FastGPT服务日志中会出现[ERROR] sse error: Premature close报错，错误栈信息…
故障排查GitHub Issue
解决FastGPT初始化数据库时MySQL 1045访问被拒绝的问题
解决FastGPT初始化数据库时MySQL 1045访问被拒绝的问题 现象 部署后服务多次尝试启动均失败，日志中重复出现固定报错：failed to initialize database, got error Error 1045 (28000): Access denied for user 'root…
故障排查GitHub Issue
解决FastGPT私有部署中MySQL容器启动失败的问题
解决FastGPT私有部署中MySQL容器启动失败的问题 现象 在WSL Ubuntu22.04.3环境中，通过docker compose快速部署FastGPT时，MySQL容器无法正常启动，部署流程卡在容器启动环节。用户提供的报错截图显示MySQL启动存在异常，但未直接给出具体报错文本，仅通过修改镜像版…
故障排查GitHub Issue
FastGPT配置n1n API时的常见问题排查与解决
FastGPT配置n1n API时的常见问题排查与解决 现象 用户在FastGPT中配置n1n API作为大语言模型提供商时，可能出现无法加载可用模型列表、调用模型时返回认证失败或连接超时等报错。 可能原因 可能的异常原因包括：配置的n1n API密钥无效或未获得对应模型的访问权限；填入的基础URL与官方要…
故障排查GitHub Issue
解决FastGPT的neapi服务因MySQL 1130错误重启的问题
解决FastGPT的neapi服务因MySQL 1130错误重启的问题 现象 FastGPT的neapi服务持续处于重启状态，查看服务日志可发现循环重复以下内容： - 打印failed to initialize database, got error Error 1130: Host '172.19.0.…
故障排查GitHub Issue
解决FastGPT定制升级Next.js14后的包配置冲突报错问题
解决FastGPT定制升级Next.js14后的包配置冲突报错问题 现象 在FastGPT 4.6.9定制开发后升级Next.js到14版本，改用turbopack作为打包工具，合并4.8.x版本代码时，出现报错：Error: The packages specified in the 'transpile…
故障排查GitHub Issue
排查并修复FastGPT项目依赖的Next.js安全漏洞问题
排查并修复FastGPT项目依赖的Next.js安全漏洞问题 现象 当FastGPT项目依赖的Next.js版本处于受影响范围时，可能面临未授权远程代码执行、中间件认证被绕过、服务器端请求伪造等安全风险。 可能原因 问题源于项目使用的Next.js版本存在公开安全漏洞： 1. CVE-2025-66478：…
故障排查GitHub Issue
解决FastGPT通过Nginx代理时文档解析接口报404错误
解决FastGPT通过Nginx代理时文档解析接口报404错误 现象 用户在私有部署V4.8.10-fix2版本的FastGPT中，通过Nginx代理调用/api/v1/chat/completions接口上传文件进行文档解析时，返回404错误。不使用Nginx直接访问FastGPT服务时，文档解析功能可以…