JeecgBoot项目中Ollama语言大模型配置问题解析

【免费下载链接】JeecgBoot 🔥企业级低代码平台集成了AI应用平台，帮助企业快速实现低代码开发和构建AI应用!前后端分离架构 SpringBoot，SpringCloud、Mybatis，Ant Design4、 Vue3.0、TS+vite！强大的代码生成器让前后端代码一键生成，无需写任何代码! 引领AI低代码开发模式: AI生成->OnlineCoding-> 代码生成-> 手工MERGE，显著的提高效率，又不失灵活~ 项目地址: https://gitcode.com/jeecgboot/JeecgBoot

问题背景

在JeecgBoot 3.8.0版本中，当用户尝试集成Ollama语言大模型时，可能会遇到一个典型的配置错误。具体表现为：在应用配置该模型后，进行对话时会抛出"调用大模型接口失败:Expected URL scheme 'http' or 'https' but no colon was found"的错误提示。

错误现象分析

从错误信息来看，系统在尝试调用大模型接口时，期望得到一个有效的HTTP或HTTPS URL，但实际上获取到的URL格式不符合要求。这种错误通常发生在URL字符串缺少必要的协议前缀(如http://或https://)时。

根本原因

深入分析后发现，问题的根源在于数据库配置。具体来说，JeecgBoot的airag_model表中credential字段在配置Ollama大模型时被设置为空对象{}，而系统期望该字段至少包含一个apiKey值。当credential字段为空时，系统无法正确处理模型调用请求，导致URL格式验证失败。

解决方案

解决此问题的方法很简单：手动修改airag_model表中对应记录的credential字段，为其添加一个apiKey值即可。即使这个密钥值不是真实的（可以随意填写），也能解决当前的错误问题。例如：

{"apiKey":"dummy-key"}

这种设计可能源于JeecgBoot框架对模型认证信息的统一处理逻辑，即使某些模型(如Ollama)可能不需要实际的apiKey，系统仍期望credential字段包含基本的键值结构。

技术启示

1. 配置完整性检查：在集成第三方服务时，应该对配置项的完整性进行验证，特别是对于必填字段应有明确的校验逻辑。

2. 默认值处理：对于可选配置项，系统应提供合理的默认值，而不是完全留空，以避免因配置不完整导致的运行时错误。

3. 错误信息友好性：当前的错误信息虽然指出了URL格式问题，但没有直接关联到配置缺失的根本原因，可以进一步优化错误提示。

4. 向后兼容性：在框架设计中，对于不同模型的认证方式差异应做好兼容处理，避免因模型特性不同导致的配置异常。

最佳实践建议

对于JeecgBoot项目中使用Ollama或其他大模型的开发者，建议：

1. 在配置模型时，确保credential字段至少包含基本的键值结构
2. 定期检查数据库中的模型配置信息是否完整
3. 对于开源模型集成，了解其实际的认证需求，避免不必要的配置项
4. 关注项目更新日志，了解相关配置要求的变更

通过以上分析和建议，开发者可以更好地在JeecgBoot项目中集成和使用Ollama等语言大模型，避免类似的配置问题。

【免费下载链接】JeecgBoot 🔥企业级低代码平台集成了AI应用平台，帮助企业快速实现低代码开发和构建AI应用!前后端分离架构 SpringBoot，SpringCloud、Mybatis，Ant Design4、 Vue3.0、TS+vite！强大的代码生成器让前后端代码一键生成，无需写任何代码! 引领AI低代码开发模式: AI生成->OnlineCoding-> 代码生成-> 手工MERGE，显著的提高效率，又不失灵活~ 项目地址: https://gitcode.com/jeecgboot/JeecgBoot