先说个背景，咱们聊聊 Spring AI 和 OpenAI 兼容协议的大模型

说实话，这玩意儿听起来高大上，实际上折腾起来跟装配乐高差不多。

哈哈，你要是刚刚跑进来还没弄清楚概念，别急，我慢慢给你捋。

Spring AI 本身是 Spring 官方推出的 AI 抽象层，核心就是 ChatClient。

只要配好几个属性，底层到底是 OpenAI、京东云还是 DeepSeek，你根本不知道。

这就像喝奶茶，你点了“珍珠”，店里到底是黑糖还是水果味的，谁在乎呢？

JDK 必须 17 以上，建议直接装 JDK 21，省得后面报错。

Spring Boot 用Zui新的 3.x 系列，不然会出现 “ClassNotFoundException: RestClientAutoConfiguration”。

别忘了在 pom.xml 里加入 Spring AI BOM，这玩意儿负责统一版本。

    
        
            org.springframework.ai
            spring-ai-bom
            1.0.0
            pom
            import
        
    

接下来加上 OpenAI 兼容协议的 starter：

    
        org.springframework.ai
        spring-ai-starter-model-openai
    
    
        org.springframework.boot
        spring-boot-starter-web
    

Zui核心的三个：base-url, api-key, model。

下面给你一个通用模板：

spring.ai.openai.base-url=https://api.deepseek.com
spring.ai.openai.api-key=YOUR_DEEPSEEK_KEY
spring.ai.openai.chat.options.model=deepseek-chat
# Ru果对方没有 Embedding 接口，记得关掉
spring.ai.model.embedding=none

这里的 # Ru果对方没有 Embedding 接口... hen重要，不然启动会报错。

这个问题经常被问到，其实原因hen简单：内容缺乏唯一性，加上爬虫频率太低。

换句话说Ru果你的页面和别人的几乎一模一样，或者你的网站根本不给爬虫留机会，那百度自然就不收录啦。

解决办法？写点原创、加点结构化数据、Zuo好 robots.txt 的放行。哈哈，这不就是我们现在干的活嘛！你懂的。

package com.example.ai.controller;
import org.springframework.ai.chat.client.ChatClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping
public class ChatController {
    private final ChatClient chatClient;
    public ChatController {
        this.chatClient = builder.build;
    }
    @GetMapping
    public String chat String message) {
        return chatClient.prompt
                         .user
                         .call
                         .content;
    }
}

注意，这里我们直接注入了 ChatClient.Builder, Spring AI 会自动把前面的配置绑定进去。

Spoiler：Sprint AI 编译时基于 Spring Framework 6.x，对应的是 Spring Boot 3.x。Ru果你还在用老版本的 Boot 2.x，那肯定报错。

# 正确写法spring.ai.model.embedding=none
# 错误写法spring.ai.openai.embedding.enabled=false

# 不对不对，这段代码里其实Yi经把旧属性标记为废弃了要改成新写法才行。

Caution：# 坑4：artifactId 命名变geng Spring AI .-M7 对 starter 进行了重命名：

./mvnw spring-boot:run
# 启动后打开浏览器访问：
curl http://localhost:8080/ai/chat?message=今天天气怎么样
# 正常返回类似：
{
   "content":"今天天气晴朗，Zui高温度28℃..."
}

String prompt = """
你是一位经验丰富的 Java 老师。
请用通俗易懂的话解释 Spring Bean 的生命周期。
""";
String answer = chatClient.prompt
                         .system
                         .user
                         .call
                         .content;
System.out.println;