故障排查GitHub issue3 分钟阅读排错/错误码

FastGPT私有部署安装插件时内部服务器错误的排查与解决

使用私有部署版本4.14.6.1的FastGPT时,在安装插件的过程中,系统返回Internal Server Error。

现象

使用私有部署版本4.14.6.1的FastGPT时,在安装插件的过程中,系统返回Internal Server Error。对应容器日志显示:[Error] 2026-02-22 17:56:12 System unexpected error: /api/core/plugin/admin/installWithUrl, Internal Server Error,同时包含接口请求栈信息Error: Internal Server Error\n at j.request (/app/projects/app/.next/server/chunks/97150.js:1:19331)\n at process.processTicksAndRejections (node:internal/process/task_queues:95:5)\n at async a (/app/projects/app/.next/server/pages/api/core/plugin/admin/installWithUrl.js:1:8121),此外还记录了/api/core/plugin/admin/installWithUrl的请求启动日志,以及fastgpt-plugin的/api/tools/upload/install POST请求记录。

可能原因

根据报错日志可初步推测,可能的原因包括:插件安装接口/api/core/plugin/admin/installWithUrl处理异常、插件安装请求超时、插件安装流程中的内部环节出错,或相关依赖服务运行异常。

排查步骤

  1. 查看FastGPT容器的完整报错日志,提取/api/core/plugin/admin/installWithUrl接口的详细错误栈与请求上下文信息。
  2. 检查fastgpt-plugin容器的日志,确认/api/tools/upload/install接口的调用是否正常完成,排查插件上传环节的异常。
  3. 核对当前FastGPT的部署版本为4.14.6.1,需按实际环境确认插件与当前版本的兼容性。
  4. 检查依赖服务(如aiproxy)的运行状态,确认其是否能正常响应请求。
  5. 排查服务器网络连接,确认FastGPT容器与插件服务、外部资源的网络连通性正常。

解决与验证

  1. 若为请求超时问题,可按实际环境调整接口超时相关配置。
  2. 更换或重新打包可用的插件安装包,避免因插件包损坏导致安装失败。
  3. 重启FastGPT与fastgpt-plugin容器,重置服务运行状态。
  4. 重新发起插件安装请求,验证是否不再返回Internal Server Error。
  5. 若插件成功加载并正常运行,则确认问题已解决。

来源:https://github.com/labring/FastGPT/issues/6449