1. Spring AI概述

一、前言

Spring AI 是由 Spring 团队推出的开源项目，旨在为 Java 开发者提供简洁、一致的 Spring 风格开发体验，用于构建基于生成式人工智能（GenAI）和大型语言模型（LLM）的应用程序。它通过标准化抽象层简化了 AI 能力的集成，降低开发门槛。

本专栏根据Spring AI官方文档和优秀的开源项目，并结合实际的业务思考，一方面是自己学习过程的记录和梳理，另一方面也希望能帮助读者以最小阻力快速地掌握Spring AI的核心开发能力！

二、Spring AI到底能干什么

• 提供跨 AI 供应商（如 OpenAI、Anthropic、Hugging Face 等）的一致性 API ；
• 支持多种 LLM 模型（文本、向量、语音、图像、多模态模型等）；
• 提示工程内置模板和动态提示管理，支持结构化灵活转化，如转JAVA对象POJO；
• 向量存储集成，支持 Pinecone、Redis、Elasticsearch 等向量数据库，实现检索增强生成（RAG）；
• 模型上下文协议（MCP），动态扩展 AI 工具（如 Web 搜索、数据库操作等）；
• .......

总之Spring AI 能完成几乎所有大语言模型落地场景的需求，并且大大降低开发难度！

三、环境要求

3.1 版本说明

• Spring boot : 3.4.5
• Java : 17
• Spring AI 1.0.0 GA (生产稳定版本)

3.2 Spring AI生产版本

截至到目前2025年7月，Spring AI目前最新的生产版本是 1.0.0 GA，该版本功能完善，支持同步/流式调用、多模型切换、工具调用等企业级特性，是生产环境首选，ChatClient （高级封装）成为官方推荐的核心 API ！

3.3 Spring AI快照版本

截至到目前2025年7月，Spring AI目前最新的快照版本是 1.0.0-SNAPSHOT，快照版本仅发布在 Spring 官方快照仓库中，开发者必须显式配置该仓库地址，否则项目将无法解析 spring-ai-bom 或相关 Starter 依赖（如 spring-ai-openai-spring-boot-starter）

<!--配置Spring AI 的快照仓库-->
<repositories>
  <repository>
    <id>spring-snapshots</id>
    <name>Spring Snapshots</name>
    <url>https://repo.spring.io/snapshot</url>
    <releases>
      <enabled>false</enabled>
    </releases>
  </repository>
  <repository>
    <name>Central Portal Snapshots</name>
    <id>central-portal-snapshots</id>
    <url>https://central.sonatype.com/repository/maven-snapshots/</url>
    <releases>
      <enabled>false</enabled>
    </releases>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
  </repository>
</repositories>

PS : 注意如果我们maven配置了仓库（如阿里云公共仓库），会覆盖所有仓库，导致 Maven 只从阿里云仓库下载依赖，而阿里云仓库中没有 Spring AI 的快照版本。需要在 settings.xml 的 <mirrors> 中排除 spring-snapshots 和 central-portal-snapshots, 比如：

<mirror>
  <id>aliyunmaven</id>
  <name>阿里云公共仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
  <mirrorOf>*,!spring-snapshots,!central-portal-snapshots</mirrorOf>
</mirror>

3.4 依赖管理

spring-ai-bom 是 Spring AI 项目的 Bill of Materials (BOM，物料清单)。它的核心作用是集中管理 Spring AI 相关依赖项的版本。即内部定义了Spring AI模块 （例如 spring-ai-openai, spring-ai-azure-openai等）以及它们所依赖的第三方库的推荐兼容版本， 当你声明 Spring AI 模块依赖时（如 spring-ai-openai），不再需要手动指定版本号 <version>。BOM 会自动为你提供该版本号。

  <!--Spring AI模块的依赖版本管理-->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.ai</groupId>
                <artifactId>spring-ai-bom</artifactId>
                <!--正式生产版本：1.0.0 GA（2025年5月20日发布）是首个稳定且支持生产环境的版本，ChatClient 成为官方推荐的核心 API-->
                <version>1.0.0</version> <!-- GA 版本 -->
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

四、参考文档

4.1 Spring AI官方文档： Getting Started :: Spring AI Reference

 --------------------------如果文章对你有帮助，别忘了点赞支持一下，谢谢~~--------------------------