Spring AI 入门教程：Java 开发者 10 分钟跑通第一个 AI 应用

你的 Java 代码  → ChatClient（统一门面）    → ChatModel（模型客户端）      → HTTP 请求        → OpenAI / 通义千问 / DeepSeek / Ollama / Azure …

<!-- pom.xml --><project>  <properties>    <spring-ai.version>1.0.0</spring-ai.version>  </properties>  <dependencyManagement>    <dependencies>      <dependency>        <groupId>org.springframework.ai</groupId>        <artifactId>spring-ai-bom</artifactId>        <version>${spring-ai.version}</version>        <type>pom</type>        <scope>import</scope>      </dependency>    </dependencies>  </dependencyManagement>  <dependencies>    <!-- Spring Web（必须） -->    <dependency>      <groupId>org.springframework.boot</groupId>      <artifactId>spring-boot-starter-web</artifactId>    </dependency>    <!-- 选一个模型 Starter（版本由 BOM 管理，无需写版本号） -->    <!-- ① OpenAI（生产推荐） -->    <dependency>      <groupId>org.springframework.ai</groupId>      <artifactId>spring-ai-starter-model-openai</artifactId>    </dependency>    <!-- ② 本地免费测试用 Ollama -->    <!-- <dependency>      <groupId>org.springframework.ai</groupId>      <artifactId>spring-ai-starter-model-ollama</artifactId>    </dependency> -->    <!-- ③ 阿里云通义千问（国内开发者） -->    <!-- <dependency>      <groupId>com.alibaba.cloud.ai</groupId>      <artifactId>spring-ai-alibaba-starter</artifactId>    </dependency> -->  </dependencies></project>

# src/main/resources/application.yml# ① OpenAI 配置spring:  ai:    openai:      api-key: ${OPENAI_API_KEY}          # 从环境变量读取，不要写死      chat:        options:          model: gpt-4o-mini               # 或 gpt-4o、o1-mini 等          temperature: 0.7# ② Ollama 本地配置（免费，无需 Key）# spring:#   ai:#     ollama:#       base-url: http://localhost:11434#       chat:#         options:#           model: llama3.2                # 或 qwen2.5:7b、deepseek-r1 等# ③ 阿里云通义千问# spring:#   ai:#     alibaba:#       dashscope:#         api-key: ${QWEN_API_KEY}#         chat:#           options:#             model: qwen-turboserver:  port: 8080

package com.example.demo;import org.springframework.ai.chat.client.ChatClient;import org.springframework.web.bind.annotation.*;@RestController@RequestMapping("/ai")public class ChatController {    private final ChatClient chatClient;    // Spring AI 自动注入 ChatClient.Builder，按配置自动选择模型    public ChatController(ChatClient.Builder builder) {        this.chatClient = builder.build();    }    // GET /ai/chat?question=今天天气怎么样    @GetMapping("/chat")    public String chat(@RequestParam String question) {        return chatClient                .prompt()           // ① 开始构建 Prompt                .user(question)     // ② 设置用户输入                .call()             // ③ 发送给模型并等待响应                .content();         // ④ 提取文本内容返回    }    // 流式SSE接口，浏览器逐块接收内容    @GetMapping(value = "/stream", produces = "text/event-stream;charset=UTF-8")public Flux<String> stream(@RequestParam String question) {    return chatClient            .prompt()            .user(question)            .stream()            .content();}}

# 设置 API Key 环境变量（macOS / Linux）export OPENAI_API_KEY=sk-your-key-here# Windows PowerShell# $env:OPENAI_API_KEY="sk-your-key-here"# 启动应用./mvnw spring-boot:run

# 测试（非流式）curl "http://localhost:8080/ai/chat?question=用一句话介绍Java"# 测试（流式）curl "http://localhost:8080/ai/stream?question=Java和Python有什么区别"

ChatClient.Builder was auto-configured for OpenAIChatModel: OpenAiChatModel started

import org.springframework.ai.chat.prompt.PromptTemplate;// 定义模板，{topic} 和 {style} 是占位符private static final PromptTemplate POEM_TEMPLATE =        new PromptTemplate("用{style}风格写一首关于{topic}的诗");public String generatePoem(String topic, String style) {    Prompt prompt = POEM_TEMPLATE.create(            Map.of("topic", topic, "style", style)    );    return chatClient.prompt(prompt).call().content();}// 调用示例generatePoem("春天", "七言绝句");

// 定义接收结构public record WeatherResult(String city, String temp, String condition) {}// 调用时加 .entity(类名.class)WeatherResult result = chatClient        .prompt("查询北京今天的天气，以JSON格式返回：{\"city\":\"北京\",\"temp\":\"XX℃\",\"condition\":\"XX\"}")        .call()        .entity(WeatherResult.class);   // 直接得到 POJO，无需解析 JSON 字符串System.out.println(result.city());      // 北京System.out.println(result.temp());      // 28℃