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

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