2026 年 6 月 12 日 · 基于 Spring Boot 4.1.0 · MCP SDK 2.0 + Anthropic 重构 + ToolCalling 体系重写
🔥 一、发布概况：为期半年的重大升级
2026 年 6 月 12 日，Spring 官方正式发布 Spring AI 2.0.0。这是 Spring AI 项目自 1.0.0 GA 以来最大的一次版本升级，从 1.1.x 到 2.0.0 历经多个 RC 阶段，积累了大量的 Breaking Changes 和功能重构。
⚡ 二、2.0.0 核心新特性
1️⃣ Anthropic 模块全面迁移至官方 Java SDK
这是 2.0.0 最重大的架构变更。 Spring AI 的 Anthropic 模块从自实现的 API 客户端彻底迁移到 Anthropic 官方 Java SDK：
新增四个 Chat Options：
spring.ai.anthropic.chat.web-search-tool.*— Web 搜索工具配置优先级容量层（Priority capacity tier）支持
完整缓存断点追踪器（CacheBreakpointTracker）
缓存资格解析器（CacheEligibilityResolver）
2️⃣ MCP SDK 2.0 深度集成
MCP（Model Context Protocol）的支持在 2.0.0 中经历了一次重大架构变革：
3️⃣ Tool Calling 体系全面重构
这是 2.0.0 影响面最广的变更。
① 内部工具执行循环 → ToolCallingAdvisor
这一变更意味着：不再需要为每个 AI 供应商单独配置工具循环，Spring AI 会自动检测并注册工具执行能力。
② 对话历史管理重构
对话历史从 ToolContext 中彻底移除——工具只接收参数和自定义上下文，不再管理对话状态。ToolCallingAdvisor 负责维护工具调用间的对话历史。
③ 流式工具调用修复
之前 streamToolCallResponses 存在设计缺陷——中间请求块被流式输出但对应的响应未被发送，导致对话历史损坏。2.0.0 中此选项被移除，默认行为已修复。
④ 工具上下文 API 变更
// 1.x
chatClient.prompt()
.tools(t -> t.callbacks(myCallback).context("tenantId", "acme"))
.call().content();
// 2.0.0
chatClient.prompt()
.tools(myCallback)
.toolContext(Map.of("tenantId", "acme"))
.call().content();4️⃣ ChatClient Options 全栈重构
5️⃣ 模型配置属性重构
配置属性大幅简化：
yaml
# 1.x
spring.ai.openai.embedding.options.model=text-embedding-3-small
2.0.0
spring.ai.openai.embedding.model=text-embedding-3-small
所有 *.options.* 层级中的 options. 被移除，直接使用 *.model 等属性。
6️⃣ TTS / OpenAI SDK 迁移
OpenAI TTS 模块从
SpeechModel→TextToSpeechModel（统一接口）OpenAI Chat 模块全面使用 Jackson 2（移除 Jackson 3 的混合使用）
OpenAI 底层 SDK 统一迁移到 OpenAI Java SDK
7️⃣ Azure OpenAI Entra ID 支持
新增 Entra ID 身份认证管理，通过干净的自动配置实现 Azure OpenAI 的安全访问。
📊 三、从 1.x 到 2.0：性能与架构提升
架构层面的飞跃
性能改进点
⚠️ 四、差距与不足
已知问题
与竞品的差距
🔮 五、未来演进方向
短期（2.x 系列）
中长期
📌 六、升级建议
从 1.1.x 升级
从 1.0.x 升级
强烈建议做一次大的 API 映射审计，因为从 1.0.x 到 2.0.0 跨越了 1.1.x 和 2.0.0-RC，积累了数百项 API 变更。
📌 七、总结
Spring AI 2.0.0 是 Spring 生态在 AI 集成领域的一次里程碑式升级。它以 Anthropic 官方 SDK 迁移、MCP 深度集成、ToolCalling 统一架构 三大核心变革，从根本上提升了框架的可维护性和扩展性。
三个核心信号
🏆 MCP 成为一等公民 — 传输模块迁入 Spring AI 项目，验证机制默认开启，Spring 在 MCP 生态中的话语权显著增强
🏆 Tool Calling 的统一是架构正确方向 — 从"每个模型自实现"到"统一 Advisor"，是 Spring AI 走向成熟的关键一步
🏆 告别"保姆级"默认值 — 默认温度移除、Options 重构、配置扁平化——Spring AI 正在从"新手友好"走向"专业级框架"
一句话总结
Spring AI 2.0.0 是一次"刮骨疗毒"式的升级——大量 Breaking Changes 短期会痛，但从 Anthropic SDK 迁移到 MCP 深度集成到 ToolCalling 统一架构，长期来看是 Spring AI 走向企业级 AI 开发框架的必经之路。
本文原创作者：易君召，详见：https://www.yijunzhao.cn/authors/yijunzhao，转载请注明出处。
欢迎访问 小易撩挨踢