Spring AI 从入门到选型：千问接入、核心功能与 JDK

Spring AI 从入门到选型：千问接入、核心功能与 JDK 收费避坑指南

适用读者：Java / Spring 开发者、架构师、技术选型负责人

---

1. Spring AI 是干嘛用的？

Spring AI 是 Spring 官方推出的 AI 应用开发框架，核心目标是：让 Java 开发者用熟悉的 Spring 方式，把 AI 能力无缝集成到企业级系统中。

过去，大模型工具链多集中在 Python 生态，而企业级系统大量基于 Spring 技术栈，导致集成成本高。Spring AI 的出现，就是为了打破这层壁垒，把模型交互、向量数据库、提示工程、工具调用等能力，变成 Spring 生态里的“原生组件”。

一句话总结：Spring AI 是企业级 AI 集成的“粘合剂”。

---

2. Spring AI 支持千问吗？

支持，而且有多种集成路径。

集成方式	说明	适用场景
Spring AI Alibaba	阿里云基于 Spring AI 构建的扩展项目，深度适配 DashScope 和通义千问系列，支持 qwen-max、qwen-plus、qwen-turbo 等，提供流式输出、函数调用、可观测性	推荐，国内项目首选
OpenAI 兼容模式	使用 Spring AI 的 OpenAI starter，将 base-url 指向阿里云兼容端点，模型名填 qwen-max 等	想复用现有 OpenAI 代码，快速接入
Ollama 本地部署	本地拉取 qwen2.5、qwen3 等模型，通过 Spring AI 的 Ollama starter 调用	离线、私有化、数据敏感场景

注意：OpenAI 兼容模式下，千问特有参数（如 enable_thinking）可能需要特殊处理。

---

3. 除了接入模型，Spring AI 还有什么功能？

Spring AI 不只是“模型客户端”，它提供了一整套构建生产级 AI 应用的标准化组件：

• 提示工程与模板：通过 PromptTemplate 动态生成提示词，避免字符串拼接。
• 结构化输出：将模型返回直接映射为 Java 对象（POJO），类型安全。
• 对话记忆：自动维护多轮对话上下文，轻松构建有“记忆”的聊天机器人。
• 工具调用：通过 @Tool 注解将普通 Java 方法暴露给模型，实现 AI 与外部系统交互。
• 检索增强生成（RAG）：内置 ETL 框架和向量存储抽象，兼容 PGVector、Milvus、Redis 等。
• 多模态支持：支持图像、音频、视频等作为输入，传递给多模态模型。
• Advisor 拦截器：可插拔拦截器链，用于提示词改写、安全过滤、日志记录等。
• 可观测性：基于 Micrometer 提供指标和追踪，监控 token 用量、调用延迟。
• 模型评估：支持对 AI 输出进行系统性评估。
• 模型上下文协议（MCP）：提供 MCP 客户端和服务器支持，方便模型与外部工具交互。
• 企业级生产特性：支持虚拟线程、GraalVM 原生镜像、Spring Boot DevTools。

---

4. Spring AI 对 JDK 的要求

Spring AI 版本	最低 JDK	配套环境
Spring AI 1.x	JDK 17	Spring Boot 3.x
Spring AI 2.x	JDK 21	Spring Boot 4.0 / Spring Framework 7.0
Spring AI Alibaba	JDK 17+	Spring Boot 3.x

选型建议：

• 现有项目基于 JDK 17 / Spring Boot 3.x：选择 Spring AI 1.x 或 Spring AI Alibaba。
• 新项目或已升级到 JDK 21 / Spring Boot 4.x：可以考虑 Spring AI 2.x。

---

5. JDK 21 是收费版本吗？

JDK 21 本身是免费的，但 Oracle JDK 21 的免费商业使用窗口即将关闭。

根据 Oracle 的免费条款与条件（NFTC），Oracle JDK 21 的免费商用期限与下一个 LTS 版本（JDK 25）发布后一年挂钩。

关键时间线

• 免费窗口关闭日：2026 年 9 月 16 日
• 最后一个免费更新：2026 年 7 月季度更新
• 开始收费节点：2026 年 10 月安全更新起，转为 OTN 许可证
• 费用参考：Java SE Universal 订阅按公司员工总数计费，约 15 美元/人/月 起

截至 2026-09-14，距离 Oracle JDK 21 免费商业窗口关闭仅剩 2 天。

免费替代方案

如果你不想受 Oracle 许可政策影响，可以迁移到完全免费、开源的 OpenJDK 发行版：

• Eclipse Temurin
• Amazon Corretto
• 腾讯 Kona JDK
• Azul Zulu
• IBM Semeru
• Microsoft Build of OpenJDK

这些发行版基于 GPLv2 许可证，可永久免费用于生产和商业用途。

---

6. 总结与选型建议

• Spring AI 的定位：企业级 AI 应用的基础设施，不只是模型接入。
• 千问支持：推荐使用 Spring AI Alibaba，也支持 OpenAI 兼容模式和 Ollama 本地部署。
• JDK 选型：
  • Spring AI 1.x / Alibaba：JDK 17+
  • Spring AI 2.x：JDK 21
• Oracle JDK 21 用户：务必在 2026-09-16 前评估迁移到免费 OpenJDK 发行版，避免高额订阅费用和合规风险。

免责声明：许可证与价格信息可能变化，请以 Oracle 官方和对应发行版文档为准。