现象
FastGPT 4.9.6私有部署版本中,知识库内的图片在预览阶段可正常显示,但在问答环节偶发无法加载的问题。其中,手动上传到nginx /images静态目录的markdown图片、pdf解析生成的base64嵌入图片(路径格式为/api/system/img/图片名称)可正常预览,但问答时部分图片路径会被自动补充无关域名,导致原路径失效,图片无法显示。
可能原因
4.9.6版本新增了知识库工具调用结果自动补充图片域名的功能,该功能可能误将本地相对路径或未指定正确域名的图片路径,自动追加了与内容相关的域名,破坏了原有的有效路径格式,导致图片无法正常加载。
排查步骤
- 检查知识库中图片的原始路径格式,确认是否为相对路径或未携带完整域名的路径,例如是否为/images/xxx或/api/system/img/xxx格式。
- 对比知识库预览与问答生成回复中的图片URL,确认是否出现额外被追加的域名片段。
- 核对nginx的location配置,确认/images路径指向正确的静态文件目录,/api路径正确转发至FastGPT服务。
- 复现问题,记录触发异常的具体场景,例如特定格式的markdown图片是否会触发该问题。
解决与验证
临时规避方案:将知识库中的图片路径替换为携带完整正确域名的URL,例如https://你的域名/images/图片名称,重新上传至知识库后发起问答,确认图片可正常显示。若需彻底解决该问题,可等待版本更新修复该自动补充功能的误判逻辑,或按实际部署环境调整相关配置(需按实际环境确认)。