SpringBoot3整合SpringAI：打造带记忆的AI助手

SpringBoot3 集成 SpringAI 打造具备上下文记忆的AI助手

在开发智能图片社区项目时，用户需要一个能持续记忆对话上下文的AI助手。经过多方案对比，最终采用 Spring Boot 3 + Spring AI + Redis 组合。下面从环境搭建到核心代码，再到测试验证，一步步拆解完整实现流程。

1. 项目全景概览

本指南详细讲解如何基于 Spring Boot 3 整合 Spring AI，构建一个具备记忆能力的AI助手。方案使用 Redis 作为持久化存储，支持按用户隔离会话，并保留30天的对话历史记录。

技术选型栈

• Spring Boot 3.3.0
• Java 17
• Spring AI
• Redis 6.0+
• MyBatis Plus
• MySQL 8.0
• Sa-Token（用户鉴权）

2. 前期环境准备

2.1 安装必要软件

• JDK 17+：Oracle JDK 或 OpenJDK 均可
• Maven 3.9+：从 Maven 官网下载
• Redis 6.0+：Redis 官网 或通过 Docker 快速部署
• MySQL 8.0+：MySQL 官网 或 Docker 容器
• IDE：IntelliJ IDEA 或 Eclipse

2.2 环境变量配置

确认 JAVA_HOME 与 MAVEN_HOME 已正确设置。

3. 项目初始化流程

3.1 创建 Spring Boot 项目

通过 Spring Initializr 生成项目骨架：

• 访问 Spring Initializr 网站
• 选择 Spring Boot 3.3.0
• 选择 Java 17
• 添加依赖：Spring Web, Spring Data Redis, MyBatis Plus, MySQL Driver, Spring Boot DevTools

3.2 Maven 依赖配置

在 pom.xml 中引入下述依赖：

    
    
        org.springframework.boot
        spring-boot-starter-web
    
    
    
        org.springframework.boot
        spring-boot-starter-data-redis
    
    
    
        com.baomidou
        mybatis-plus-boot-starter
        3.5.5
    
    
    
        com.mysql
        mysql-connector-j
        runtime
    
    
    
        org.springframework.ai
        spring-ai-openai
        1.0.0
    
    
    
        cn.dev33
        sa-token-spring-boot-starter
        1.38.1
    
    
    
        com.fasterxml.jackson.core
        jackson-databind
    
    
    
        org.projectlombok
        lombok
        true
    
    
    
        org.springframework.boot
        spring-boot-starter-test
        test
    

4. 核心配置详解

4.1 应用配置文件 (application.yml)

新建 src/main/resources/application.yml，填入以下应用参数：

server:
  port: 9527
  servlet:
    context-path: /api
spring:
  application:
    name: smart-pic-community-backend
  # Redis 配置
  data:
    redis:
      database: 2
      host: localhost
      port: 6379
      timeout: 5000
  # 数据库配置
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/smart_pic_community
    username: root
    password: your_password
  # Spring AI 配置
  ai:
    openai:
      base-url: https://api.deepseek.com/  # 使用 DeepSeek API
      api-key: your_api_key
      chat:
        options:
          model: deepseek-chat

4.2 Redis 配置类 (RedisConfiguration.java)

编写 Redis 配置，确保对象序列化正确：

package com.spc.smartpiccommunitybackend.config;

import com.fasterxml.jackson.annotation.JsonAutoDetect;
import com.fasterxml.jackson.annotation.PropertyAccessor;
import com.fasterxml.jackson.databind.ObjectMapper;
import lombok.extern.slf4j.Slf4j;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.RedisConnectionFactory;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.data.redis.serializer.Jackson2JsonRedisSerializer;
import org.springframework.data.redis.serializer.StringRedisSerializer;

@Configuration
@Slf4j
public class RedisConfiguration {

    @Bean
    public RedisTemplate redisTemplate(RedisConnectionFactory redisConnectionFactory) {
        log.info("开始创建redis模板对象...");
        RedisTemplate redisTemplate = new RedisTemplate<>();
        // 设置连接工厂
        redisTemplate.setConnectionFactory(redisConnectionFactory);
        // 使用 StringRedisSerializer 来序列化和反序列化 redis 的 key
        StringRedisSerializer stringRedisSerializer = new StringRedisSerializer();
        // key 采用 String 的序列化方式
        redisTemplate.setKeySerializer(stringRedisSerializer);
        redisTemplate.setHashKeySerializer(stringRedisSerializer);
        // 使用 Jackson2JsonRedisSerializer 来序列化和反序列化 redis 的 value
        Jackson2JsonRedisSerializer