FastGPT常见功能异常与配置问题排查与解决指南

现象

记录FastGPT相关异常与需求：应用市场无分类功能，分享链接无法记录用户对话内容；关联多个知识库时，匹配结果仅优先返回首个匹配知识库内容；部署于外地服务器时，数据库时间比本地少几小时；无法使用非原生GPT-4 API，缺少代理配置项；应用缺少固定开头问候词功能；嵌入uniapp页面时，web-view或iframe加载报_next/目录下JS错误；QA知识库引用内容过少，仅返回数十个字符的文本；建议添加语音录制转文本与回答语音播放功能。

可能原因

部分异常的潜在关联因素：数据库默认取本地时间，可能导致服务器与本地时间偏差；uniapp嵌入页面时，window内置对象无法正常使用，引发_next/目录JS报错；知识库匹配逻辑暂无明确异常指向；GPT-4代理配置项未提供；语音功能实现后会影响复制体验。

排查步骤

1. 检查服务器时区与本地时区差异，确认数据库时间偏差情况
2. 逐一测试关联的各知识库匹配结果，验证多知识库匹配逻辑
3. 排查uniapp嵌入页面的window对象使用限制，定位_next/目录JS报错原因
4. 核对GPT-4 API相关配置参数，确认是否存在代理配置项缺失
5. 查看应用配置项，确认是否存在开头问候词相关功能开关

解决与验证

1. 数据库时间偏差：数据库默认取本地时间，不影响业务使用，需按实际环境确认调整方式
2. 应用市场与分类、分享记录功能：应用市场将在v4版本统一重做，相关功能可提交PR迭代
3. 知识库匹配问题：暂无明确异常原因，建议自行测试知识库匹配度
4. GPT-4代理配置：可添加类似gpt4proxyurl的转发链接配置，适配国内代理平台
5. uniapp嵌入报错：需按实际环境排查window内置对象使用限制
6. QA知识库引用：当前QA模式返回文本量有限，可调整配置优化
7. 语音功能：实现后会影响复制体验，相关需求可通过其他方式覆盖，暂不建议添加
8. 开头问候词功能：可考虑添加开关，优先级较低

来源: FastGPT GitHub issue #96