一、前言

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

?--------------------------如果文章對你有幫助，別忘了點贊支持一下，謝謝~~--------------------------