2.0.0-M6
Spring AI 2.0.0-M6 正式发布,累计合并 616 个提交,涉及 2205 个文件(+122407 / -88783 行)。这是继 1.1.x 后的首个 2.0 里程碑版本,包含大量破坏性变更——Spring Boot 4.1、MCP SDK 2.0、选项类不可变化、模块移除等。
核心依赖升级
| 依赖 | 旧版本 | 新版本 |
|---|---|---|
| Spring Boot | 3.5.14 | 4.1.0-RC1 |
| MCP Java SDK | 0.18.2 | 2.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-client、spring-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 仍可能变动。