跳到主要内容

2.0.0-M6

云端
Spring AI 学习者

Spring AI 2.0.0-M6 正式发布,累计合并 616 个提交,涉及 2205 个文件(+122407 / -88783 行)。这是继 1.1.x 后的首个 2.0 里程碑版本,包含大量破坏性变更——Spring Boot 4.1、MCP SDK 2.0、选项类不可变化、模块移除等。

核心依赖升级

依赖旧版本新版本
Spring Boot3.5.144.1.0-RC1
MCP Java SDK0.18.22.0.0-M2
OpenAI Java SDK-4.34.0(官方 SDK)
Kotlin-2.3.20

破坏性变更

Options 类不可变化

所有模型厂商的 Options 类移除了 Setter 方法,全面采用 Builder + withXxx() 不可变模式。受影响模块:

  • OpenAI、Azure OpenAI、Anthropic、DeepSeek、Mistral AI、MiniMax、Google GenAI、Vertex AI、ElevenLabs、Stability AI、Bedrock、PostgresML
// 旧方式(不再支持)
options.setModel("gpt-5");
options.setTemperature(0.5);

// 新方式(Builder 模式)
OpenAiChatOptions options = OpenAiChatOptions.builder()
.model("gpt-5")
.temperature(0.5)
.build();

// 或使用 withXxx() 创建新实例
options = options.withTemperature(0.3);

模块移除

  • Azure OpenAI —— 模块已从 BOM 移除
  • SAP HANA DB 向量存储 —— 模块已移除
  • Infinispan 向量存储 —— 模块已移除
  • spring-ai-openai-sdk —— 已合并至 spring-ai-openai,后者现在使用 OpenAI 官方 Java SDK
  • PromptChatMemoryAdvisor —— 完全移除,使用 MessageChatMemoryAdvisor 替代

Properties 重构

  • OpenAiConnectionProperties 重命名为 OpenAiCommonProperties
  • 多处自动配置 Properties 类重构

MCP SDK 2.0 迁移

MCP Java SDK 2.0.0-M2 引入全新的 API,spring-ai-starter-mcp-clientspring-ai-starter-mcp-server 的编程式配置和自动配置均受影响。

新功能

  • 统一缓存用量指标 —— Usage 接口新增 getCacheUsage() 方法
  • ChatModel 默认 buildRequestPrompt —— ChatModel 接口新增默认 buildRequestPrompt() 方法
  • Null-safety —— 大量模块完成 null-safety 迁移
  • Qdrant 1.17 —— 升级至 Qdrant 1.17

Spring AI 2.0.0-M6 是里程碑预览版本,不建议生产环境直接升级。正式版发布前 API 仍可能变动。