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

解决FastGPT 4.15.1本地开发出现[plugin_error]: fetch failed报错的问题

解决FastGPT 4.15.1本地开发出现[pluginerror]: fetch failed报错的问题 本地开发FastGPT 4.15.1版本时,出现[pluginerror]: fetch failed报错,系统初始化步骤instrumentation-check失败,完整报错详情包含errorM…

现象

本地开发FastGPT 4.15.1版本时,出现[plugin_error]: fetch failed报错,系统初始化步骤instrumentation-check失败,完整报错详情包含errorMessage: '[plugin_error]: fetch failed',且无明确的错误堆栈与错误名称信息。该问题在使用4.15.0-beta3版本的docker-compose.cn.yml配置时可正常运行,未出现同类报错。

可能原因

当前仅能明确该报错仅出现在FastGPT 4.15.1本地开发环境中,对比可正常运行的4.15.0-beta3版本配置存在差异,具体触发根因需结合实际环境的依赖加载、网络请求、插件配置等情况确认,暂无可直接匹配的公开明确根因信息。

排查步骤

  1. 确认当前运行的FastGPT版本为4.15.1,且为本地开发环境,排除版本与部署方式的干扰;
  2. 对比可正常运行的4.15.0-beta3版本的docker-compose.cn.yml配置,逐项检查当前本地开发的配置差异,重点关注插件相关的配置项;
  3. 检查本地开发环境的网络连通性,确认是否存在请求拦截、超时或域名解析异常等问题,排查fetch failed相关的网络异常;
  4. 查看系统初始化时instrumentation-check步骤的详细日志,获取更多报错上下文信息,辅助定位具体触发点。

解决与验证

若需快速恢复服务运行,可尝试切换至4.15.0-beta3版本,使用其docker-compose.cn.yml配置启动服务,验证是否可正常完成系统初始化与运行;若必须使用4.15.1版本,需按实际环境排查依赖配置、网络连通性、插件加载逻辑等问题,确认无fetch failed类插件报错后,即可验证运行正常。

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