🌱 从 0 开始 Spring AI

一个全面、易懂、可运行的 Spring AI 学习指南，助你快速构建 AI 增强型 Java 应用。

完整版PDF，输出内容 2w+ ，请访问Gitee：从 0 开始 Spring AI

📖 中文教程 | 阿里云通义千问集成 | 可运行示例 | 持续更新

---

📚 目录

• 环境准备
• 快速入门
  • 1. 获取通义千问 API Key
  • 2. 引入依赖
  • 3. 配置文件
  • 4. 编写控制器
  • 5. 运行效果
• 后期规划
• 许可证
• 致谢

---

⚙️ 环境准备

• ✅ Java 17 或更高版本
• ✅ Maven 3.6+
• ✅ Spring Boot 3.1+
• ✅ 通义千问大模型账号（阿里百炼平台）
• ✅ Docker（可选，用于运行向量数据库）

---

🚀 快速入门

1. 获取通义千问 API Key

前往 阿里百炼平台 注册账号，创建应用并获取 DASHSCOPE_API_KEY。

🔐 建议将密钥配置为环境变量，避免泄露。

---

2. 引入依赖

在 pom.xml 中添加以下依赖管理与 Starter：

<properties>
    <spring-ai.version>1.0.0</spring-ai.version>
    <spring-ai-alibaba.version>1.0.0.2</spring-ai-alibaba.version>
    <spring-boot.version>3.5.4</spring-boot.version>
    <java.version>17</java.version>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.alibaba.cloud.ai</groupId>
            <artifactId>spring-ai-alibaba-bom</artifactId>
            <version>${spring-ai-alibaba.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>${spring-boot.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <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>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>com.alibaba.cloud.ai</groupId>
        <artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

---

3. 配置文件

创建 application.yml，配置通义千问模型：

spring:
  ai:
    alibaba:
      dashscope:
        api-key: ${DASHSCOPE_API_KEY} # 推荐使用环境变量
        chat:
          model: qwen-plus # 可选: qwen-turbo, qwen-max, qwen-vl 等

💡 提示：可通过环境变量 DASHSCOPE_API_KEY=your_key_here 启动应用。

---

4. 编写控制器

创建一个简单的聊天接口：

@RestController
public class ChatController {

    private final ChatClient chatClient;

    public ChatController(ChatClient.Builder builder) {
        this.chatClient = builder.build();
    }

    @GetMapping("/chat")
    public Flux<String> chat(
            @RequestParam(defaultValue = "你是谁") String message,
            HttpServletResponse response) {
        response.setCharacterEncoding("UTF-8");
        return chatClient.prompt()
                         .user(message)
                         .stream()
                         .content();
    }
}

---

5. 运行效果

启动应用后，访问：

http://localhost:8080/chat?message=你好，Spring AI！

你将看到通义千问以 流式响应（Streaming） 返回回答，支持中文，响应迅速。

🎯 提示：浏览器中可看到逐字输出效果，适合构建聊天机器人界面。

---

📅 后期规划

我们计划持续更新以下内容：

• 项目实战：构建 AI 客服、智能文档问答系统
• Graph 教程：使用 Spring AI Flow 构建复杂 AI 工作流
• LangChain4j 系列教程：对比学习 Java 生态主流 AI 框架
• 向量数据库集成：Chroma、PGVector、Milvus 实战
• RAG（检索增强生成）完整案例

欢迎在 Issues 中提出你感兴趣的专题！

---

📄 许可证

本项目基于 Apache 2.0 许可证 开源，可自由使用、修改和分发。

---

🙏 致谢

• 📚 Spring AI 官方文档
• 📚 Spring AI Alibaba 官方文档
• 💡 阿里云通义实验室
• 🌍 以及所有开源社区贡献者

---

🎯 立即开始你的 Spring AI 之旅吧！