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

解决FastGPT BI图表生成插件提示Public S3服务未初始化的问题

FastGPT 4.14.5版本中,使用官方插件市场的BI图表生成插件生成图片时,会提示报错"Public S3 service not initialized. Call initS3Service() first"。

现象

FastGPT 4.14.5版本中,使用官方插件市场的BI图表生成插件生成图片时,会提示报错"Public S3 service not initialized. Call initS3Service() first"。通过查看日志可知,该报错来自fastgpt-plugin容器,且宿主机的minio服务与fastgpt-public存储桶均运行正常。

可能原因

该报错明确提示S3服务未初始化,需先调用initS3Service(),核心原因为fastgpt-plugin容器内的S3服务初始化逻辑未正确执行,或容器未正确加载S3服务的相关配置。尽管宿主机minio与存储桶正常,但插件容器可能存在配置缺失、网络连通异常或初始化流程未触发的问题。

排查步骤

  1. 确认当前使用的FastGPT版本为4.14.5,核对版本信息与问题场景是否匹配。
  2. 查看fastgpt-plugin容器的运行日志,确认是否存在"Public S3 service not initialized. Call initS3Service() first"的报错内容,定位报错来源。
  3. 检查fastgpt-plugin容器的S3相关配置是否正确加载,需按实际环境确认配置参数的完整性与准确性。
  4. 验证fastgpt-plugin容器与minio服务的网络连通性,需按实际环境确认网络配置是否正常。
  5. 确认fastgpt-public存储桶的权限配置是否允许fastgpt-plugin容器访问,需按实际环境确认权限设置。

解决与验证

首先补充或修正fastgpt-plugin容器的S3服务配置,确保配置参数与minio服务的实际配置一致,需按实际环境填写相关参数。随后重启fastgpt-plugin容器,使新配置生效。验证时,重新使用BI图表生成插件尝试生成图片,确认不再出现指定报错,且图片生成成功。同时再次查看fastgpt-plugin容器的日志,确认无该初始化相关报错。

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