TroubleshootingOfficial documentation15 min readIssue list

FastGPT Model serving and inference Issue List

Explore Model serving and inference Issue List with symptom-based checks, published article links and practical guidance for troubleshooting your deployment.

This page collects the 41 published documents about self-hosted inference services and model integration, grouped by symptom, so a document can be found directly from what the error looks like.

Three symptoms that belong to this stage

  1. The inference endpoint is reachable but calls fail
  2. Retrieval behaves differently after changing an embedding or rerank model
  3. Channel and credential setup in the model proxy layer

If none of the three match, go back to the deployment and environment issue landscape and narrow down again.

The general order for this stage

  1. Take the full error from the backend service log for this stage's component, including the component name and error code
  2. Verify from inside the deployment that the component can be reached on its own, ruling out network and permission causes
  3. Check the component version against the main service version
  4. Follow the entry below whose symptom is closest, then repeat the same operation to verify

Published documents (41)

DocumentArea
Add Custom SiliconCloud Models to FastGPTdeploy
Add MiniMax Models to FastGPT Self-Hosted Deploymentsdeploy
Add Multilingual Model Provider Display Namesmodel
Add Valid Models to FastGPT Provider Presetsmodel
Add a Model to an Existing FastGPT Providermodel
Add a New Model Provider to FastGPTmodel
Add and Maintain FastGPT Model Presetsmodel
Add and Use Ollama Models in FastGPTdeploy
Clarify FastGPT Dataset Processing Model Rolestutorial
Deploy ChatGLM2 Models via FastGPT Source Codedeploy
Deploy M3E Large Model API for FastGPTdeploy
Deploy Qwen Models Using Xinference for FastGPTdeploy
Deploy and Use Custom ChatGLM2 and M3E Models on FastGPTdeploy
Download BGE Rerank Model Code for FastGPTdeploy
Download BGE Reranker Models for FastGPT Deploymentdeploy
Enable and Map FastGPT AI Modelsdeploy
Fix Non-Native Model Question Classification Issuesdeploy
Install Ollama for FastGPT Self-Hosted Deploymentsdeploy
Install Ollama on Host Machine for FastGPTdeploy
Install and Deploy Xinference for FastGPT Custom Modelsdeploy
Integrate Local Models For FastGPT Via One APIdeploy
Integrate Local Models via Xinference with FastGPTdeploy
Integrate Qwen Local Model with FastGPTdeploy
Launch Xinference Models via Command Line Interfacedeploy
Manage and Access FastGPT Model Call Logsdeploy
Match FastGPT Channel IDs to AIProxy Protocolsmodel
Replace OneAPI with AI Proxy for FastGPTdeploy
Resolve FastGPT Empty Model Response Errorsdeploy
Set Up Direct Ollama Integration With FastGPTdeploy
Set Up FastGPT AI Model Basic Settingstutorial
Set Up FastGPT AIProxy Protocol Entriesmodel
Set Up FastGPT Custom Model Request URLsdeploy
Set Up M3E Embedding Models in FastGPTdeploy
Set Up Ollama AI Proxy Integration for FastGPTdeploy
Set Up and Manage FastGPT Model Channelsdeploy
Test Custom ChatGLM2 Models on FastGPTdeploy
Test Custom ChatGLM2 and M3E Models on FastGPTdeploy
Troubleshoot FastGPT Model Availability Errorsdeploy
Understand FastGPT Model Preset Directory Structuresmodel
Validate Ollama Connectivity for FastGPT Deploymentsdeploy
Validate Updated FastGPT Model Preset Changesmodel

What this list does not cover

Entries cover cases that can be reproduced publicly, grouped by symptom. The following need separate confirmation:

  • A symptom caused by several factors at once, which needs the order above to rule them out one by one
  • The same symptom caused by configuration specific to the commercial edition
  • Cases coupled to a particular infrastructure environment that cannot be reproduced in a standard deployment

Keep reading

References

If the problem is still not located

The entries above cover cases that can be reproduced from public information. If the problem depends on configuration details of a specific deployment, or needs runtime logs to confirm, contact sales for deployment-stage support; the cloud service can be used directly without handling environment dependencies.

  • Contact sales: support for self-hosting and upgrades
  • Get started: use the cloud service and skip environment setup
  • Pricing: compare what the cloud and self-hosted forms cover