首页
/ Spring AI 1.0.0-M7 版本中模型启动器命名变更解析

Spring AI 1.0.0-M7 版本中模型启动器命名变更解析

2025-06-11 14:56:11作者:卓艾滢Kingsley

在Spring AI项目升级到1.0.0-M7版本后,开发者可能会遇到模型启动器依赖不可用的问题。本文将详细解析这一变更背后的技术原因,并指导开发者如何正确使用新版本的依赖配置。

命名规范变更背景

Spring AI团队在1.0.0-M7版本中对项目结构进行了优化调整,其中最重要的变化之一就是统一了模型启动器的命名规范。这一变更旨在使项目结构更加清晰,便于开发者理解和使用。

新旧命名对比

在早期版本中,模型启动器的命名模式为:

spring-ai-{model}-spring-boot-starter

而在1.0.0-M7及后续版本中,新的命名模式调整为:

spring-ai-starter-model-{model}

以Mistral AI为例:

  • 旧版本:spring-ai-mistral-ai-spring-boot-starter
  • 新版本:spring-ai-starter-model-mistral-ai

变更带来的优势

  1. 命名一致性:新的命名模式更加统一,便于记忆和使用
  2. 结构清晰:通过"starter-model"的命名方式,明确表示了这是一个模型相关的启动器
  3. 扩展性强:为未来可能添加的其他类型启动器预留了命名空间

升级建议

对于正在升级项目的开发者,建议采取以下步骤:

  1. 检查项目中所有Spring AI相关的依赖
  2. 将所有模型启动器的依赖按照新规范进行更新
  3. 确保版本号统一为1.0.0-M7
  4. 重新构建项目并测试功能

常见模型启动器示例

以下是几个常见模型在新旧版本中的依赖配置对比:

Mistral AI

<!-- 旧版本 -->
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-mistral-ai-spring-boot-starter</artifactId>
    <version>1.0.0-M6</version>
</dependency>

<!-- 新版本 -->
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-model-mistral-ai</artifactId>
    <version>1.0.0-M7</version>
</dependency>

Ollama

<!-- 旧版本 -->
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-ollama-spring-boot-starter</artifactId>
    <version>1.0.0-M6</version>
</dependency>

<!-- 新版本 -->
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-model-ollama</artifactId>
    <version>1.0.0-M7</version>
</dependency>

总结

Spring AI 1.0.0-M7版本的命名规范变更是项目成熟过程中的重要一步,虽然短期内可能会给升级带来一些困扰,但从长远来看,这种更规范的命名方式将提高项目的可维护性和易用性。开发者应及时更新项目依赖,以适应这一变化。

登录后查看全文
热门项目推荐
相关项目推荐