现象
使用私有部署版本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处理异常、插件安装请求超时、插件安装流程中的内部环节出错,或相关依赖服务运行异常。
排查步骤
- 查看FastGPT容器的完整报错日志,提取
/api/core/plugin/admin/installWithUrl接口的详细错误栈与请求上下文信息。 - 检查fastgpt-plugin容器的日志,确认
/api/tools/upload/install接口的调用是否正常完成,排查插件上传环节的异常。 - 核对当前FastGPT的部署版本为4.14.6.1,需按实际环境确认插件与当前版本的兼容性。
- 检查依赖服务(如aiproxy)的运行状态,确认其是否能正常响应请求。
- 排查服务器网络连接,确认FastGPT容器与插件服务、外部资源的网络连通性正常。
解决与验证
- 若为请求超时问题,可按实际环境调整接口超时相关配置。
- 更换或重新打包可用的插件安装包,避免因插件包损坏导致安装失败。
- 重启FastGPT与fastgpt-plugin容器,重置服务运行状态。
- 重新发起插件安装请求,验证是否不再返回Internal Server Error。
- 若插件成功加载并正常运行,则确认问题已解决。
来源:https://github.com/labring/FastGPT/issues/6449