# Springai-Alibaba-SpringBoot-API

**Repository Path**: ArrayEdu/Springai-Alibaba-SpringBoot-API

## Basic Information

- **Project Name**: Springai-Alibaba-SpringBoot-API
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-25
- **Last Updated**: 2025-12-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SpringBoot3+SpringAI+SpringAI Alibaba等整合教程




## 🚀 课程亮点与价值



### 源码对应的教程（以下任选其一，需要自取）：

B站：https://www.bilibili.com/cheese/play/ss537533106

网易云课堂：https://study.163.com/course/courseMain.htm?courseId=1213833867&share=2&shareId=1023275352

51CTO：https://edu.51cto.com/course/39658.html

前端：https://github.com/arraycto/Springai-Alibaba-SpringBoot-Vue.git

后端：https://bgithub.xyz/arraycto/Springai-Alibaba-SpringBoot-API.git

### 💎 课程核心价值

**10天掌握企业级AI应用开发，薪资提升+**

### 🌟 五大课程亮点

#### 1. **前沿技术组合**
- **Spring Boot 3.3.5** + **Spring AI 1.0.0-M6** 最新技术栈
- **阿里巴巴AI** + **硅基流动** 双平台AI服务集成
- **JWT认证** + **Spring Security** 企业级安全方案

#### 2. **实战项目驱动**
- 从零搭建完整的智能聊天应用
- 包含用户认证、AI集成、数据持久化完整流程
- 可直接用于求职作品集展示

#### 3. **零基础友好**
- 手把手环境搭建指导
- 通俗易懂的概念解释
- 详细的错误排查方案

#### 4. **就业导向设计**
- 覆盖企业实际开发需求
- 培养全栈开发思维
- 提升职场竞争力

#### 5. **持续学习支持**
- 完整的项目文档
- 扩展练习和进阶指导
- 社区交流支持

## 🎯 学习收益

### 🏆 能力提升

#### 技术能力
- ✅ **Spring Boot 3.x** 深度掌握
- ✅ **AI服务集成** 实战经验
- ✅ **企业级安全** 解决方案
- ✅ **数据库设计** 最佳实践
- ✅ **API开发** 完整流程

#### 职场竞争力
- 💼 **全栈开发能力**：前后端分离架构设计
- 💼 **AI应用开发**：热门技术领域竞争力
- 💼 **项目经验**：完整项目开发经验
- 💼 **问题解决能力**：实际开发问题处理

#### 薪资提升预期
- **初级开发者** → **中级开发者**：薪资提升30-50%
- **Java开发者** → **AI应用开发者**：技术转型成功
- **传统开发** → **现代化开发**：技术栈升级

### 📊 就业方向
- **AI应用开发工程师**：15-25K/月
- **Java后端开发工程师**：12-20K/月
- **全栈开发工程师**：18-30K/月
- **技术架构师**：25-50K/月

## 🎯 适合人群
- **零基础初学者**：想要学习现代Java开发
- **有Java基础者**：希望掌握Spring Boot和AI集成
- **全栈开发者**：需要后端API开发技能
- **AI爱好者**：想要了解AI服务集成

## 📋 学习前提
- 基本的Java语法知识（类、方法、接口等概念）
- 了解HTTP协议基本概念
- 会使用基本的命令行操作

## 🎓 讲师介绍

### 高薪启蒙Array老师

**Array老师**是国内知名的全栈开发专家和AI应用开发布道者，拥有10年+的互联网大厂实战经验，曾主导多个千万级用户产品的架构设计与开发。

#### 专业背景
- **技术专长**：Java全栈开发、AI应用集成、微服务架构
- **大厂经历**：先后就职于知名一线互联网公司
- **教学经验**：累计培养学员超过10000+，帮助数千名学员实现薪资翻倍

#### 教学理念
- **实战驱动**：以企业真实项目为导向，注重动手能力培养
- **循序渐进**：从基础到进阶，让每位学员都能跟上学习节奏
- **就业导向**：紧密结合市场需求，培养企业急需的技术人才

#### 学员评价
> "Array老师的课程通俗易懂，即使是零基础也能轻松上手，跟着老师的步骤一步步做，很快就掌握了Spring Boot和AI应用开发。" - 张同学，现就职于某知名互联网公司，薪资25K

> "感谢Array老师，通过课程学习不仅提升了技术能力，更重要的是掌握了企业级项目的开发思路和方法，让我成功转型为全栈工程师。" - 李同学，薪资提升40%

## 项目概述

这是一个基于 Spring Boot 3.3.5 和 Spring AI 1.0.0-M6 的智能聊天应用项目，集成了阿里巴巴AI服务和硅基流动平台，提供完整的用户认证和聊天功能。

### 🌟 项目特色
- **现代化架构**：使用最新的Spring Boot 3.x
- **AI集成**：轻松调用多种AI模型
- **企业级安全**：完整的JWT认证体系
- **实时聊天**：支持流式响应
- **模块化设计**：清晰的代码结构

## 技术栈

### 核心框架
- **Spring Boot 3.3.5** - 应用框架
- **Spring Security** - 安全认证
- **Spring Data JPA** - 数据持久化
- **Spring AI** - AI集成框架

### AI服务集成
- **阿里巴巴AI服务** - 通过OpenAI兼容接口
- **硅基流动平台** - 支持多种AI模型
    https://cloud.siliconflow.cn/me/models
    
    ![大模型清单](大模型清单.jpg)

### 数据库
- **MySQL 8.0** - 关系型数据库
- **JPA/Hibernate** - ORM框架

### 安全认证
- **JWT** - JSON Web Token认证
- **Spring Security** - 安全框架

### 工具库
- **Lombok** - 代码简化
- **Hutool** - 工具集合
- **UserAgentUtils** - 用户代理解析

## 项目结构分析

```
src/main/java/com/richqi/
├── SpringAiAlibabaApplication.java     # 应用主类
├── auth/                               # 认证模块
│   ├── config/                         # 安全配置
│   ├── controller/                     # 用户控制器
│   ├── dto/                           # 数据传输对象
│   ├── entity/                        # 实体类
│   ├── repository/                    # 数据仓库
│   ├── security/                      # 安全组件
│   ├── service/                       # 业务服务
│   └── util/                          # 工具类
├── chat/                              # 聊天模块
│   └── controller/                    # 聊天控制器
├── common/                            # 公共组件
│   ├── OpenAiStreamResponse.java      # 流式响应
│   ├── RequestParams.java             # 请求参数
│   └── VectorStoreConfig.java         # 向量存储配置
└── config/                            # 配置类
    ├── AiPlatformConfig.java          # AI平台配置
    └── ModelConfig.java               # 模型配置
```

## 核心功能模块

### 1. 用户认证系统

#### 功能特性
- 用户注册/登录
- JWT令牌认证
- 角色权限管理
- 跨域请求支持

#### 核心文件
- `UserController.java` - 用户管理接口
- `SecurityConfig.java` - 安全配置
- `JwtAuthenticationTokenFilter.java` - JWT过滤器
- `UserDetailsServiceImpl.java` - 用户详情服务

#### 学习要点
```java
// JWT令牌生成
@Autowired
private JwtTokenUtil jwtTokenUtil;

public String generateToken(String username) {
    return jwtTokenUtil.generateToken(username);
}

// 安全配置
@Configuration
@EnableWebSecurity
public class SecurityConfig {
    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http.authorizeHttpRequests(authz -> authz
            .requestMatchers("/auth/**").permitAll()
            .anyRequest().authenticated()
        );
        return http.build();
    }
}
```

### 2. AI聊天服务

#### 功能特性
- 支持多种AI模型（通义千问、深度求索等）
- 流式聊天响应
- 会话管理
- 模型切换

#### 核心文件
- `ChatController.java` - 聊天接口
- `AgentsController.java` - 智能体管理
- `DataSetsController.java` - 数据集管理
- `SystemController.java` - 系统管理

#### 学习要点
```java
// AI聊天集成
@Autowired
private ChatClient chatClient;

public Flux<String> chatStream(String message) {
    return chatClient.prompt()
        .user(message)
        .stream()
        .content();
}

// 模型配置
@ConfigurationProperties(prefix = "spring.ai.siliconflow")
public class AiPlatformConfig {
    private String apiKey;
    private String baseUrl;
    private ChatOptions chat;
}
```

### 3. 配置管理系统

#### 功能特性
- 多AI平台支持
- 动态模型配置
- 环境变量管理

#### 核心配置
```yaml
spring:
  ai:
    platform: siliconflow
    siliconflow:
      api-key: ${AI_API_KEY}
      base-url: https://api.siliconflow.cn
      chat:
        options:
          temperature: 0.7
          max-tokens: 2048

system:
  models:
    qwen3:
      name: Qwen3
      model-name: Qwen/Qwen3-8B
    deepseek:
      name: DeepSeek-R1
      model-name: deepseek-ai/DeepSeek-R1
```

## 🚀 零基础入门指南

### 重要概念解释（先理解再动手）

#### 1. Spring Boot 是什么？
- **简单理解**：一个"快速启动"Java项目的工具
- **作用**：帮你自动配置很多复杂的东西
- **好处**：不用写很多重复代码，专注业务逻辑
- **类比**：就像搭积木，Spring Boot帮你准备好了各种形状的积木块

#### 2. AI服务集成是什么？
- **简单理解**：让程序能够"说话"和"思考"
- **实现方式**：调用外部AI服务商的API
- **本项目**：集成了阿里巴巴和硅基流动的AI服务
- **类比**：就像打电话，你的程序"打电话"给AI服务商，AI服务商"回答"你的问题

#### 3. JWT认证是什么？
- **简单理解**：一种"电子门票"系统
- **工作方式**：登录后获得令牌，后续请求带上令牌
- **安全性**：防止未授权访问
- **类比**：就像去游乐园，买票后获得手环，凭手环玩各种项目

### 🎯 学习心态建议
1. **不要怕犯错**：编程就是不断试错的过程
2. **循序渐进**：先跑通项目，再理解代码
3. **多动手实践**：只看不练等于没学
4. **善用搜索**：遇到问题先搜索，再提问

### 🔧 必备工具清单

#### 开发工具
- **IntelliJ IDEA Community版**（免费）
- **Postman**（API测试工具）
- **Git Bash**（命令行工具）

#### 环境配置
- **JDK 17**：Java开发环境
- **Maven 3.8+**：项目管理工具
- **MySQL 8.0**：数据库

#### 浏览器插件（可选）
- **JSON Formatter**：美化JSON显示
- **Postman Interceptor**：拦截浏览器请求

## 📚 学习路径

### 第一阶段：基础环境搭建（1-2天）

#### 1.1 环境准备（详细步骤）

**步骤1：安装JDK 17**
```bash
# 检查是否已安装
java -version

# 如果未安装，下载地址：https://adoptium.net/
# 选择JDK 17，下载后安装
```

**步骤2：安装Maven**
```bash
# 下载Maven：https://maven.apache.org/download.cgi
# 解压到C:\Program Files\apache-maven-3.9.6
# 配置环境变量
# 检查安装
mvn -version
```

**步骤3：安装MySQL 8.0**
```bash
# 下载MySQL：https://dev.mysql.com/downloads/mysql/
# 安装时设置root密码为123456（与项目配置一致）
# 启动MySQL服务
```

**步骤4：安装IDE**
- 推荐IntelliJ IDEA Community版（免费）
- 下载地址：https://www.jetbrains.com/idea/download/

#### 1.2 项目导入（手把手教学）

**方法1：直接打开项目**
1. 打开IntelliJ IDEA
2. 选择"Open"或"Open Project"
3. 选择项目文件夹 `d:\arryedu\spring-ai-alibaba`
4. IDEA会自动识别为Maven项目

**方法2：命令行操作**
```bash
# 进入项目目录
cd d:\arryedu\spring-ai-alibaba

# 编译项目（首次运行会下载依赖，需要等待）
mvn clean compile

# 如果下载慢，可以配置国内镜像
```

#### 1.3 数据库配置（详细步骤）

**步骤1：创建数据库**
```sql
-- 打开MySQL命令行或图形化工具
-- 执行以下SQL语句
CREATE DATABASE spring_ai_db CHARACTER SET utf8mb4;

-- 检查是否创建成功
SHOW DATABASES;
```

**步骤2：修改配置文件**
打开 `src/main/resources/application.yml` 文件，检查数据库配置：
```yaml
spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/spring_ai_db
    username: root
    password: 123456  # 修改为你的MySQL密码
```

**步骤3：测试连接**
```bash
# 运行项目测试
mvn spring-boot:run

# 如果看到启动日志，说明配置成功
# 正常启动日志示例：
# Started SpringAiAlibabaApplication in 3.456 seconds
```

### 🎯 新手常见问题解答

#### Q1：Maven依赖下载失败怎么办？
```bash
# 解决方案1：配置国内镜像
# 在Maven的settings.xml文件中添加阿里云镜像

# 解决方案2：清理本地仓库重新下载
mvn clean compile -U

# 解决方案3：使用代理（如果需要）
```

#### Q2：MySQL连接失败怎么办？
```sql
-- 检查MySQL服务是否启动
-- Windows: 服务中查找MySQL服务
-- 检查端口3306是否被占用
-- 检查防火墙设置
```

#### Q3：项目编译错误怎么办？
```bash
# 检查Java版本
java -version

# 检查Maven配置
mvn -version

# 清理项目重新编译
mvn clean compile
```

### 第二阶段：核心功能学习（3-5天）

#### 2.1 Spring Security 认证系统（新手友好版）

**学习目标**：理解用户登录认证的完整流程

**核心概念解释**：
- **认证（Authentication）**：验证用户身份（你是谁？）
- **授权（Authorization）**：检查用户权限（你能做什么？）
- **JWT令牌**：登录成功后获得的"电子门票"

**实践步骤**：
1. **用户注册流程**
   ```java
   // 1. 用户填写注册信息
   // 2. 系统验证信息并保存到数据库
   // 3. 返回注册成功结果
   ```

2. **用户登录流程**
   ```java
   // 1. 用户输入用户名密码
   // 2. 系统验证用户名密码
   // 3. 生成JWT令牌返回给用户
   // 4. 用户后续请求携带JWT令牌
   ```

3. **权限验证流程**
   ```java
   // 1. 拦截器检查请求是否携带JWT
   // 2. 验证JWT是否有效
   // 3. 检查用户是否有权限访问该接口
   ```

#### 2.2 Spring AI 集成（新手友好版）

**学习目标**：理解AI服务调用的基本原理

**核心概念解释**：
- **AI模型**：训练好的智能程序，可以回答问题
- **API调用**：程序向AI服务商发送请求
- **流式响应**：AI回答实时返回，像打字一样

**实践步骤**：
1. **配置AI服务**
   ```yaml
   # 在application.yml中配置
   spring:
     ai:
       siliconflow:
         api-key: "你的API密钥"
         base-url: "https://api.siliconflow.cn"
   ```

2. **调用AI服务**
   ```java
   // 发送问题给AI
   String response = chatClient.prompt()
       .user("你好，请介绍一下Spring Boot")
       .call()
       .content();
   ```

3. **测试AI功能**
   - 使用Postman测试聊天接口
   - 观察AI的响应内容

#### 2.3 数据持久化（新手友好版）

**学习目标**：理解数据如何保存到数据库

**核心概念解释**：
- **实体类（Entity）**：Java对象与数据库表的映射
- **Repository**：数据操作的接口
- **JPA**：Java持久化API，简化数据库操作

**实践步骤**：
1. **创建用户实体**
   ```java
   @Entity
   @Data
   public class User {
       @Id
       @GeneratedValue(strategy = GenerationType.IDENTITY)
       private Long id;
       private String username;
       private String password;
       private String email;
   }
   ```

2. **创建数据操作接口**
   ```java
   public interface UserRepository extends JpaRepository<User, Long> {
       User findByUsername(String username);
   }
   ```

3. **使用数据操作**
   ```java
   // 保存用户
   userRepository.save(user);
   
   // 查询用户
   User user = userRepository.findByUsername("test");
   ```

### 第三阶段：高级特性探索（2-3天）

#### 3.1 流式聊天实现
- WebFlux 响应式编程
- Server-Sent Events (SSE)
- 前端实时显示

#### 3.2 向量存储配置
- 向量数据库集成
- 语义搜索实现
- RAG（检索增强生成）

#### 3.3 性能优化
- 连接池配置
- 缓存策略
- 异步处理

## 实践练习

### 练习1：扩展用户功能
**目标**：添加用户信息修改和查询接口

```java
// 在UserController中添加
@PutMapping("/profile")
public ResponseEntity<?> updateProfile(@RequestBody UserProfileDTO profile) {
    // 实现用户信息更新逻辑
}

@GetMapping("/info")
public ResponseEntity<UserInfoVO> getUserInfo() {
    // 返回用户详细信息
}
```

### 练习2：添加新的AI模型
**目标**：集成新的AI服务提供商

```yaml
# 在application.yml中添加新配置
system:
  models:
    new-model:
      name: "新模型"
      provider: "new-provider"
      model-name: "model/name"
```

### 练习3：实现聊天历史
**目标**：保存和检索聊天记录

```java
@Entity
public class ChatHistory {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private Long userId;
    private String sessionId;
    private String message;
    private String response;
    private LocalDateTime createTime;
}
```

## 常见问题解决

### 1. 依赖下载失败
```bash
# 清理本地仓库并重新下载
mvn clean compile -U
```

### 2. 数据库连接问题
```yaml
# 检查数据库配置
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/spring_ai_db
    username: root
    password: your_password
```

### 3. JWT认证失败
```java
// 检查JWT密钥配置
jwt:
  secret: "足够长的密钥"
  expiration: 86400
```

### 4. AI服务调用失败
```yaml
# 验证API密钥和端点
spring:
  ai:
    siliconflow:
      api-key: "有效的API密钥"
      base-url: "正确的API地址"
```

## 部署指南

### 开发环境部署
```bash
# 运行应用
mvn spring-boot:run

# 或打包运行
mvn clean package
java -jar target/spring-ai-alibaba-1.0.2.jar
```

### 生产环境配置
```yaml
# 生产环境配置文件
spring:
  profiles: production
  datasource:
    url: ${DATABASE_URL}
    username: ${DB_USERNAME}
    password: ${DB_PASSWORD}
```

## 扩展学习资源

### 官方文档
- [Spring Boot 官方文档](https://spring.io/projects/spring-boot)
- [Spring AI 官方文档](https://spring.io/projects/spring-ai)
- [Spring Security 官方文档](https://spring.io/projects/spring-security)

### 相关技术
- [JWT 规范](https://jwt.io/)
- [MySQL 8.0 文档](https://dev.mysql.com/doc/)
- [OpenAI API 文档](https://platform.openai.com/docs/)

### 进阶主题
- 微服务架构设计
- 容器化部署（Docker）
- 性能监控和日志管理
- 单元测试和集成测试

## 总结

通过本教程的学习，您将掌握：

1. **Spring Boot 3.x 高级特性** - 现代Java开发最佳实践
2. **AI服务集成** - 多平台AI能力调用
3. **安全认证系统** - 企业级安全解决方案
4. **响应式编程** - 高性能实时应用开发
5. **项目架构设计** - 模块化、可扩展的系统设计

建议按照学习路径逐步实践，每个阶段完成后进行总结和反思，确保真正掌握相关技术。