mirror of
https://github.com/labring/FastGPT.git
synced 2026-05-02 01:02:05 +08:00
zjj-225
f057a2ae19
* docs(faq): 更新常见问题文档并新增注意事项页面 - 在 error.mdx 中调整问题序号并新增 OCR 配置问题 - 新增 attention.mdx 页面，提供问题排查步骤和技术支持指引 - 重构 dataset.mdx 内容结构，使用数字序号并补充知识库闪烁问题 * docs: 重构私有部署故障排查文档结构并新增详细指南 将原有的 FAQ 文档拆分为多个专题文档，包括通用问题排查、S3问题、OneAPI错误、模型可用性问题和排查方法。更新了导航菜单和目录结构，使文档组织更清晰，便于用户快速定位和解决特定问题。 新增了详细的故障排查步骤、CURL测试示例和具体错误解决方案，特别是针对对象存储连接、签名错误和模型调用失败等常见问题提供了更全面的指导。 * docs: 移除已弃用的 OneAPI 错误排查文档 移除 `oneapi-errors` 相关文档文件，因其内容已过时或合并至其他章节。同步更新中英文文档目录和元数据文件中的引用。 * docs: 更新文档FAQ内容，移除过时条目并重新编号 - 删除关于OneAPI官网的过时FAQ条目 - 重新编号故障排除FAQ章节，使序号连续 - 同步更新中英文文档内容保持一致 --------- Co-authored-by: Archer <545436317@qq.com>
96 lines
3.8 KiB
Plaintext
96 lines
3.8 KiB
Plaintext
---
|
|
title: General Troubleshooting
|
|
description: FastGPT Self-Hosting General Troubleshooting
|
|
---
|
|
|
|
### (1)Frontend Page Crash
|
|
|
|
1. 90% of cases are due to incorrect model configuration: ensure that at least one model is enabled for each category; check if some `object` parameters in the model are abnormal (arrays and objects). If empty, try giving an empty array or empty object.
|
|
2. A small part is due to browser compatibility issues. Since the project contains some high-level syntax, lower version browsers may not be compatible. You can provide specific operation steps and error information in the console to the issue.
|
|
3. Turn off the browser translation function. If the browser has translation enabled, it may cause the page to crash.
|
|
|
|
---
|
|
|
|
### (2)If deployed via sealos, are there no limitations of local deployment?
|
|
|
|
|
|
This is the length limit of the indexing model. It is the same regardless of the deployment method, but the configuration of different indexing models is different, and parameters can be modified in the background.
|
|
|
|
---
|
|
|
|
### (3)How to mount the Mini Program configuration file
|
|
|
|
Mount the verification file to the specified location: /app/projects/app/public/xxxx.txt
|
|
|
|
Then restart. For example:
|
|
|
|
|
|
|
|
---
|
|
|
|
### (4)Database port 3306 is occupied, service startup failed
|
|
|
|
|
|
|
|
Change the port mapping to 3307 or similar, for example 3307:3306.
|
|
|
|
---
|
|
|
|
|
|
### (5)Can it run purely locally?
|
|
|
|
Yes. You need to prepare the vector model and LLM model.
|
|
|
|
---
|
|
|
|
### (6)Other models cannot perform question classification/content extraction
|
|
|
|
1. Check the logs. If it prompts JSON invalid, not support tool, etc., it means that the model does not support tool calling or function calling. You need to set `toolChoice=false` and `functionCall=false`, and it will default to the prompt mode. Currently, the built-in prompts are only tested for commercial model APIs. Question classification is basically usable, but content extraction is not very good.
|
|
2. If the configuration is normal and there are no error logs, it means that the prompt may not be suitable for the model. You can customize the prompt by modifying `customCQPrompt`.
|
|
|
|
---
|
|
|
|
### (7)Page Crash
|
|
|
|
1. Turn off translation.
|
|
2. Check if the configuration file is loaded normally. If it is not loaded normally, system information will be missing, and it will cause a null pointer in some operations.
|
|
|
|
- 95% of cases are incorrect configuration files. It will prompt xxx undefined.
|
|
- Prompt `URI malformed`, please Issue feedback specific operations and pages, this is due to special string encoding parsing errors.
|
|
|
|
3. Some api incompatibility issues (rare).
|
|
|
|
---
|
|
|
|
### (8)After enabling content completion, the response speed becomes slow
|
|
|
|
1. Question completion requires a round of AI generation.
|
|
2. 3~5 rounds of queries will be performed. If the database performance is insufficient, there will be a significant impact.
|
|
|
|
---
|
|
|
|
### (9)Normal reply in the page, API error
|
|
|
|
The page uses stream=true mode, so the API also needs to set stream=true for testing. Some model interfaces (mostly domestic) are a bit garbage in non-Stream compatibility.
|
|
Same as the previous question, curl test.
|
|
|
|
---
|
|
|
|
### (10)Knowledge base indexing has no progress/indexing is very slow
|
|
|
|
First look at the log error information. There are several situations:
|
|
|
|
1. Can verify, but indexing has no progress: vector model (vectorModels) is not configured.
|
|
2. Cannot verify, nor index: API call failed. Maybe not connected to OneAPI or OpenAI.
|
|
3. Has progress, but very slow: api key is not good, OpenAI free account, only 3 times or 60 times a minute. 200 times a day limit.
|
|
|
|
---
|
|
|
|
### (11)Connection error
|
|
|
|
Network exception. Domestic servers cannot request OpenAI, check whether the connection with the AI model is normal.
|
|
|
|
Or FastGPT cannot request OneAPI (not in the same network).
|
|
|
|
---
|