Spring AI 核心亮点拆解与实战指南

不管底层是 OpenAI 的 GPT-4、阿里的通义千问，还是本地部署的 Llama3，ModelClient 都能把它们的接口转换成统一的 Java 方法。

比如调用 Chat 模型，统一用 chat() 方法：

// 管它是哪个模型，调用方式都一样
ChatResponse response = chatClient.chat(new Prompt("用 Java 代码实现单例模式"));
System.out.println(response.getResult().getOutput().getContent());

背后的奥秘是 ModelClient 的 SPI 机制——每个模型厂商只需要实现 ChatClient 接口，Spring AI 会通过自动配置加载对应的实现（类似 Spring Data 对不同数据库的适配）。

2. PromptTemplate：提示词的'模板引擎'

写提示词是 AI 开发的核心，但硬编码提示词既难维护又不灵活。PromptTemplate 就像 AI 版的 Thymeleaf，支持变量替换、条件判断，还能从文件加载模板。

比如定义一个生成邮件回复的模板（email-template.st）：

你是客服助手，请回复用户邮件：
用户问题：{{userQuestion}}
订单号：{{orderId}}
回复要求：{{requirement}}

在代码中调用：

PromptTemplate template = new PromptTemplate(
    new ClassPathResource("email-template.st"), // 加载模板
    Map.of(
        "userQuestion", "我的订单还没发货",
        "orderId", "OD123456",
        "requirement", "语气友好，说明物流进度"
    )
);
Prompt prompt = template.create(); // 生成最终提示词

这比直接字符串拼接优雅 10 倍，尤其适合需要频繁调整提示词的场景。

3. VectorStore：向量数据的'仓库管理员'

做 RAG（检索增强生成）时，需要把文档转成向量存起来，再根据用户问题的向量做相似检索。VectorStore 就是干这个的，支持 Redis、Milvus、PostgreSQL 等多种存储。

以 Redis 为例，存文档、查相似内容只需 3 步：

// 1. 初始化向量存储（自动配置 Redis 连接）
VectorStore vectorStore = new RedisVectorStore(redisTemplate, embeddingClient);

// 2. 存储文档向量
vectorStore.add(
    Document.from("Spring AI 是 Spring 生态的 AI 框架", Map.of("source", "官方文档")),
    Document.from("Spring AI 支持统一模型接口", Map.of("source", "技术博客"))
);

// 3. 检索相似文档（返回 Top2）
List<Document> docs = vectorStore.similaritySearch("Spring AI 的核心功能", 2);

底层的向量计算、存储适配全由 VectorStore 搞定，开发者不用关心'如何把文本转向量''如何计算余弦相似度'这些细节。

四、实战：10 分钟生成首个 Spring AI 项目

光说不练假把式，接下来手把手教你用 Spring Initializr 生成一个调用 OpenAI 的项目，全程不超过 10 分钟。

步骤 1：生成项目骨架

打开 Spring Initializr 官网，配置如下：

Project: Maven Language: Java Spring Boot: 3.2.x Group: com.example Artifact: spring-ai-demo

关键依赖：在'Dependencies'搜索并添加：

Spring AI OpenAI（核心依赖，提供 OpenAI 模型适配） Spring Web（方便写接口测试）

步骤 2：配置依赖（pom.xml 关键部分）

生成的项目会自动引入依赖，核心部分如下（如果手动配置，参考这个）：

<dependencies>
    <!-- Spring AI 核心 -->
    <dependency>
        <groupId>org.springframework.ai</groupId>
        <artifactId>spring-ai-core</artifactId>
    </dependency>
    <!-- OpenAI 适配 -->
    <dependency>
        <groupId>org.springframework.ai</groupId>
        <artifactId>spring-ai-openai</artifactId>
    </dependency>
    <!-- Web 依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>
<!-- Spring AI 仓库（必须加，否则拉不到依赖） -->
<repositories>
    <repository>
        <id>spring-milestones</id>
        <name>Spring Milestones</name>
        <url>https://repo.spring.io/milestone</url>
    </repository>
</repositories>

步骤 3：配置 OpenAI 密钥

在 application.properties 中添加：

# 你的 OpenAI API 密钥（从 OpenAI 官网获取）
spring.ai.openai.api-key=sk-xxxxxxx
# 可选：指定模型（默认 gpt-3.5-turbo）
spring.ai.openai.chat.model=gpt-3.5-turbo

步骤 4：写一个简单的 AI 接口

创建 AIController.java：

@RestController
public class AIController {
    // 自动注入 OpenAI 聊天客户端
    private final ChatClient chatClient;

    public AIController(ChatClient chatClient) {
        this.chatClient = chatClient;
    }

    // 暴露接口：/ai/chat?question=你的问题
    @GetMapping("/ai/chat")
    public String chat(@RequestParam String question) {
        // 调用 AI 模型
        return chatClient.chat(question);
    }
}

步骤 5：运行并测试

启动项目后，访问：

http://localhost:8080/ai/chat?question=用 Java 写一个单例模式

不出意外，会收到 AI 返回的代码：

public class Singleton {
    // 私有静态实例，懒加载
    private static volatile Singleton instance;

    // 私有构造方法，防止外部实例化
    private Singleton() {}

    // 公共静态方法，获取实例
    public static Singleton getInstance() {
        if (instance == null) {
            synchronized (Singleton.class) {
                if (instance == null) {
                    instance = new Singleton();
                }
            }
        }
        return instance;
    }
}

搞定！从项目生成到成功调用 AI，全程不到 10 分钟，这就是 Spring AI 的低门槛魅力。

五、最后：为什么说 Spring AI 是 Java 开发者的 AI 时代船票？

Spring 框架能统治 Java 生态 20 年，靠的不是技术多炫酷，而是'降低开发者门槛，解决实际问题'。Spring AI 延续了这个基因——它没发明新的 AI 算法，却把 AI 开发装进了 Java 开发者熟悉的'Spring 壳子'里。

如果你是 Java 团队，想在现有系统里平滑接入 AI 能力，不想重构技术栈，也不想让团队重新学一套工具链，Spring AI 就是最优解。