ruoyi-vue-pro/SPRING_AI_UPGRADE.md

Spring AI 升级到 1.0.0 总结

升级版本

• 从: Spring AI 1.0.0-M6
• 到: Spring AI 1.0.0 GA

主要变化

1. 依赖管理

• 新增: 添加了 Spring AI BOM 依赖管理
• 版本: 所有 Spring AI 依赖现在通过 BOM 统一管理，无需指定版本号

2. 依赖名称变更

按照新的命名模式更新了所有依赖：

模型依赖:

• spring-ai-openai-spring-boot-starter → spring-ai-starter-model-openai
• spring-ai-azure-openai-spring-boot-starter → spring-ai-starter-model-azure-openai
• spring-ai-ollama-spring-boot-starter → spring-ai-starter-model-ollama
• spring-ai-stability-ai-spring-boot-starter → spring-ai-starter-model-stability-ai
• spring-ai-zhipuai-spring-boot-starter → spring-ai-starter-model-zhipu-ai
• spring-ai-minimax-spring-boot-starter → spring-ai-starter-model-minimax

向量存储依赖:

• spring-ai-qdrant-store → spring-ai-starter-vector-store-qdrant
• spring-ai-redis-store → spring-ai-starter-vector-store-redis
• spring-ai-milvus-store → spring-ai-starter-vector-store-milvus

3. 移除的模块

以下模块在 Spring AI 1.0.0 中已被移除：

⚠️ 已移除的模块:

• Moonshot (月之暗面): spring-ai-moonshot-spring-boot-starter
• QianFan (文心一言): spring-ai-qianfan-spring-boot-starter

注意: 这些模块已移至 Spring AI Community repository。如需继续使用，请参考社区版本。

4. 代码变更

4.1 AiUtils.java

• 移除了 MoonshotChatOptions 和 QianFanChatOptions 导入
• 更新了 buildChatOptions 方法，对 YI_YAN 和 MOONSHOT 平台抛出 UnsupportedOperationException

4.2 AiModelFactoryImpl.java

• 移除了相关导入和方法：
  • buildYiYanChatModel()
  • buildQianFanImageModel()
  • buildMoonshotChatModel()
  • buildYiYanEmbeddingModel()
• 更新了所有相关的 switch 语句，对已移除的平台抛出异常

4.3 AiImageServiceImpl.java

• 移除了 QianFanImageOptions 导入
• 更新了 buildImageOptions 方法，对 YI_YAN 平台抛出异常

4.4 测试文件

删除了不兼容的测试文件：

• QianFanImageTests.java
• YiYanChatModelTests.java
• MoonshotChatModelTests.java

5. 通义千问配置

• 通义千问依赖 spring-ai-alibaba-starter 版本从 1.0.0-M6.1 更新到 1.0.0.1

兼容性说明

✅ 继续支持的模型

• OpenAI
• Azure OpenAI
• Ollama
• Stability AI
• 智谱 GLM (ZhiPu AI)
• MiniMax
• 通义千问 (TongYi)

❌ 不再支持的模型

• Moonshot (月之暗面)
• QianFan (文心一言)

🔄 迁移建议

如果您的应用程序使用了被移除的模型，建议：

1. 迁移到其他支持的模型：

   • 从 Moonshot → OpenAI、智谱GLM 或其他聊天模型
   • 从 QianFan → 通义千问、智谱GLM 或其他聊天模型

2. 使用社区版本：

   • 查看 Spring AI Community repository 获取这些模型的社区支持版本

验证升级

升级完成后，请验证：

1. ✅ 应用程序正常启动
2. ✅ 现有的 AI 功能正常工作
3. ✅ 向量存储连接正常
4. ✅ 测试覆盖的模型功能正常

参考文档

• Spring AI 1.0.0 发布说明
• Spring AI 升级指南
• Spring AI Community Repository

---

升级日期: $(date) 升级人: [请填写升级人员]