Spring AI 极简入门：15分钟集成AI到SpringBoot应用

Spring AI 极简入门：15分钟集成AI到Spring应用

零基础也能学会！基于 Spring AI Alibaba，用最简单的方式让Spring应用具备AI能力

什么是 Spring AI？

Spring AI 是一个让Java开发者轻松集成AI能力的框架。简单来说，它帮你处理了与AI服务通信的复杂细节，让你用几行代码就能调用大模型。

核心概念（简单理解）：

• ChatClient：与AI对话的工具
• Prompt：你给AI的指令
• ChatResponse：AI返回的答案

环境准备

必需环境

• JDK 17+
• Maven 3.6+

获取阿里云API密钥

1. 注册阿里云账号
2. 开通百炼平台服务
3. 获取API Key

15分钟快速开始

第1步：创建项目

访问 start.spring.io 快速创建项目：

配置选项：

• Project: Maven
• Language: Java
• Spring Boot: 3.5.7
• Group: com.example
• Artifact: spring-ai-demo
• Java: 17

依赖：

• Spring Web

点击"Generate"下载项目压缩包

第2步：添加依赖

在 pom.xml 的 <dependencies> 部分添加：

<dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-starter</artifactId>
    <version>1.0.0-M5.1</version>
</dependency>

在 <project> 标签内添加仓库配置：

<repositories>
    <repository>
        <id>spring-milestones</id>
        <url>https://repo.spring.io/milestone</url>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

全部依赖如下，以供参考：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>3.5.7</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>
	<groupId>com.example</groupId>
	<artifactId>spring-ai-demo</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<name>spring-ai-demo</name>
	<description>Demo project for Spring Boot AI</description>
	<url/>
	<licenses>
		<license/>
	</licenses>
	<developers>
		<developer/>
	</developers>
	<scm>
		<connection/>
		<developerConnection/>
		<tag/>
		<url/>
	</scm>
	<properties>
		<java.version>17</java.version>
	</properties>
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>

		<dependency>
			<groupId>com.alibaba.cloud.ai</groupId>
			<artifactId>spring-ai-alibaba-starter</artifactId>
			<version>1.0.0-M5.1</version>
		</dependency>
	</dependencies>

	<repositories>
		<repository>
			<id>spring-milestones</id>
			<url>https://repo.spring.io/milestone</url>
			<snapshots>
				<enabled>false</enabled>
			</snapshots>
		</repository>
	</repositories>

	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

</project>

第3步：配置API密钥

• 这里的API_KEY是上面获取的阿里云百炼的key

设置环境变量：

Windows:（自己在环境变量配置即可）

set AI_DASHSCOPE_API_KEY=你的API_KEY

Mac/Linux:

export AI_DASHSCOPE_API_KEY=你的API_KEY

或者在 application.yml 中配置：

spring:
  ai:
    dashscope:
      api-key: ${AI_DASHSCOPE_API_KEY}

第4步：编写AI对话接口

在 src/main/java/com/example/spring_ai_demo/ 目录下创建 AiController.java：

package com.example.spring_ai_demo;

import com.alibaba.cloud.ai.dashscope.chat.DashScopeChatOptions;
import org.springframework.ai.chat.client.ChatClient;
import org.springframework.ai.chat.client.advisor.MessageChatMemoryAdvisor;
import org.springframework.ai.chat.client.advisor.SimpleLoggerAdvisor;
import org.springframework.ai.chat.memory.InMemoryChatMemory;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/helloworld")
public class HelloworldController {
    private static final String DEFAULT_PROMPT = "你是一个博学的智能聊天助手，请根据用户提问回答！";

    private final ChatClient dashScopeChatClient;

    public HelloworldController(ChatClient.Builder chatClientBuilder) {
        this.dashScopeChatClient = chatClientBuilder
                .defaultSystem(DEFAULT_PROMPT)
                // 实现 Chat Memory 的 Advisor
                // 在使用 Chat Memory 时，需要指定对话 ID，以便 Spring AI 处理上下文。
                .defaultAdvisors(
                        new MessageChatMemoryAdvisor(new InMemoryChatMemory())
                )
                // 实现 Logger 的 Advisor
                .defaultAdvisors(
                        new SimpleLoggerAdvisor()
                )
                // 设置 ChatClient 中 ChatModel 的 Options 参数
                .defaultOptions(
                        DashScopeChatOptions.builder()
                                .withTopP(0.7)
                                .build()
                )
                .build();
    }

    @GetMapping("/simple/chat")
    public String simpleChat(String query) {
        return dashScopeChatClient.prompt(query).call().content();
    }
}

第5步：启动测试

1. 启动项目，和正常springboot项目启动方式是一样的：
   

2. 看到以下日志表示启动成功：

   Started SpringAiDemoApplication in 1.988 seconds (process running for 2.266)

3. 访问接口：

(因为通过大模型思考得到结果，所以接口返回可能慢一些，耐心等待)

http://localhost:8080/helloworld/simple/chat?query=你好，介绍一下Spring

浏览器访问：

apifox访问：

🎉 恭喜！你的第一个AI应用已经运行起来了！

测试你的应用

基础对话测试

http://localhost:8080/helloworld/simple/chat?query=用Java写一个Hello World程序

技术问题测试

http://localhost:8080/helloworld/simple/chat?query=解释一下Spring Boot的自动配置原理

遇到问题怎么办？

常见问题解决

❌ 问题1：依赖下载失败

✅ 解决：检查是否添加了Spring仓库配置

❌ 问题2：API密钥错误

✅ 解决：确认环境变量名是 AI_DASHSCOPE_API_KEY

❌ 问题3：JDK版本错误

✅ 解决：用 java -version 检查，确保是JDK 17+

快速检查清单

• start.spring.io 项目创建成功
• pom.xml 依赖和仓库配置正确
• 环境变量已设置
• 代码复制无误
• 应用启动成功（看到Started日志）

下一步学什么？

成功运行基础版本后，你可以尝试：

1. 给AI设定角色 - 让AI成为编程助手、翻译专家等
2. 处理复杂对话 - 实现多轮对话记忆
3. 文件处理 - 让AI读取和分析文档
4. 其他AI服务 - 尝试OpenAI、Azure等

总结

通过这个极简教程，你已经学会了：

• ✅ 使用start.spring.io快速创建项目
• ✅ 添加Spring AI依赖
• ✅ 配置API密钥
• ✅ 创建AI对话接口
• ✅ 测试应用

Spring AI让AI集成变得异常简单，现在你可以在任何Spring项目中快速添加AI能力了！

---

相关链接

• Spring Initializr
• 阿里云百炼平台

标签: #SpringAI #入门教程 #JavaAI #SpringBoot #阿里云百炼