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

解决FastGPT 4.11.1私有部署pnpm dev启动的模型URL解析报错问题

使用pnpm dev命令启动FastGPT 4.11.1私有部署版本时,编译完成后会打印加载各数据库表的日志,随后显示MongoDB连接成功的信息,最终抛出加载模型错误。

现象

使用pnpm dev命令启动FastGPT 4.11.1私有部署版本时,编译完成后会打印加载各数据库表的日志,随后显示MongoDB连接成功的信息,最终抛出加载模型错误。具体报错文本为TypeError: Failed to parse URL from /model/list,调用栈涉及tsRestFetchApiloadSystemModels等函数,最终指向instrumentation.ts中的注册逻辑。

可能原因

该报错的核心原因是请求模型列表接口时,无法解析相对路径的/model/list。由于未正确配置模型接口的基础访问地址,导致程序无法将相对路径拼接为完整的可访问URL,从而触发URL解析失败的错误。

排查步骤

  1. 确认当前使用的FastGPT版本为4.11.1,核对项目依赖的@fastgpt-sdk/plugin版本是否与该版本匹配。
  2. 检查启动前的环境配置,确认是否正确设置了模型接口的基础访问地址,避免仅使用相对路径作为请求地址。
  3. 查看报错指向的代码文件,如packages/service/core/ai/config/utils.ts中的loadSystemModels函数,确认请求URL的拼接逻辑是否正确。
  4. 测试当前终端环境的网络连通性,确认可以正常访问配置的模型接口地址。

解决与验证

根据排查结果修正配置:将模型接口的相对路径替换为完整的可访问URL,或确保启动环境可以正确解析相对路径的基础地址。重新执行pnpm dev启动命令,观察日志是否不再出现Load models error TypeError: Failed to parse URL from /model/list的报错,同时确认MongoDB连接正常、系统模型列表加载成功,即可验证问题解决。

来源:FastGPT GitHub issue