故障排查官方文档2 分钟阅读故障排查

FastGPT skill模块missingImageRepository错误码详细说明

该错误属于FastGPT的skill模块,是SkillErrEnum枚举中定义的错误项,枚举名为missingImageRepository,对应的statusText为missingImageRepository,关联的国际化文案键为common:codeerror.skillerror.missingi…

这个错误是什么

该错误属于FastGPT的skill模块,是SkillErrEnum枚举中定义的错误项,枚举名为missingImageRepository,对应的statusText为missingImageRepository,关联的国际化文案键为common:codeerror.skillerror.missingimagerepository,模块错误码前缀为agentSkill: 509000。

什么情况下会触发

该错误会在skill模块的业务逻辑检测到缺失镜像仓库相关必要配置时触发,属于技能配置校验失败的场景之一。当技能配置中未正确填写或缺少镜像仓库相关参数时,模块校验逻辑会抛出该错误,用于提示配置不完整。

怎么定位(可照做的步骤)

  1. 查看目标技能的配置详情,核对镜像仓库相关配置项是否完整存在;
  2. 检索系统返回的错误信息,确认是否包含statusText为missingImageRepository的报错内容;
  3. 关联错误对应的国际化文案键common:codeerror.skillerror.missingimagerepository,确认当前错误与该枚举项匹配。

处理与验证

处理该错误需补充完整技能配置中的镜像仓库相关必要信息,确保配置符合skill模块的校验规则。验证时可重新提交技能配置操作,确认错误不再触发,且技能可正常运行。若配置完成后仍出现该错误,可再次核对配置项的完整性与正确性,确保所有必填参数均已填写。

来源: FastGPT 官方来源

适用性与版本范围

本页适用于官方来源记录的 故障排查 场景。执行变更前,需核对 FastGPT、依赖、API 与部署版本。

安全护栏

凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。

回滚指引

恢复变更前的技术内容权威快照、已保存配置与数据快照,再执行最小验证场景。