版
最新版本与兼容性矩阵
Version & Compatibility Matrix
Spring AI 这摊生态更新极快，版本号、starter 名字、配置 key 都会变。下表是你上手前必须钉死的几个坐标：底座 JDK、Spring Boot 版本、Spring AI GA 版本、spring-ai-alibaba 版本、接哪些模型。具体小版本号以 Spring AI 和 spring-ai-alibaba 官方文档（java2ai.com）最新稳定版为准，本表只给大方向。
| 组件 | 版本（当前稳定线） | 说明 |
|---|---|---|
| JDK | 17+（必须） | Spring Boot 3.x 起最低要求 JDK 17，Spring AI 跟着走。 |
| Spring Boot | 3.2.x / 3.3.x | Spring AI 1.0 的底座，别拿 Boot 2.x 凑。 |
| Spring AI | 1.0.0 GA（2025 正式发布，当前稳定） | ChatClient / VectorStore / EmbeddingModel 这套抽象正式定型。 |
| Spring AI | 1.1.x（演进中） | 更新特性，新项目以官网最新稳定版为准。 |
| spring-ai-alibaba | 1.0.0.x（当前 1.0.0.2 一线） | 阿里为 Spring AI 做的百炼/DashScope 适配，接通义千问。 |
| BOM | spring-ai-alibaba-bom:1.0.0.2 | 用 BOM 统一管所有 spring-ai-alibaba 依赖版本。 |
| 核心 Starter | spring-ai-alibaba-starter-dashscope | 引入它，自动装配 DashScopeChatModel / ChatClient。 |
底层支持哪些模型
Spring AI 是抽象层，换模型只换 starter 和配置，业务代码（ChatClient 那套）一行不改。当前主流接入：
| 模型来源 | 对应 Starter / 说明 |
|---|---|
| OpenAI | GPT-4o 等，官方 spring-ai-starter-model-openai。 |
| Anthropic | Claude 系列，官方 starter。 |
| 通义千问 Qwen | spring-ai-alibaba-starter-dashscope，qwen-max / plus / turbo / qwen-vl。 |
| 智谱 GLM | 智谱开源 starter。 |
| Ollama 本地模型 | spring-ai-starter-model-ollama，跑 Llama / Qwen 本地版，不花 API 钱。 |
两个阿里系框架，别搞混
| 框架 | 定位 |
|---|---|
| spring-ai-alibaba | Java 生态，Spring AI 的百炼适配 + Agent/Graph 编排，本页主线。 |
| AgentScope | 阿里多 Agent 框架，核心是 Python，现在也有 agentscope-java（JVM 版）。第九章细讲。 |
| java2ai.com | spring-ai-alibaba 的官方文档 / 教程站，"帮 Java 开发者步入 AI Native 时代"，本页很多写法的出处。 |
版本三连查
跑不起来先按这顺序排：① JDK 是不是 17+；② Spring Boot 版本和 Spring AI 版本配不配；③ spring-ai-alibaba-bom 版本和 spring-ai 版本配不配。生态变化快，以 java2ai.com/docs 下当前版本文档为准，本页示例写法可能略滞后。