Spring AI 实战：手把手教你建立支持多会话管理的智能聊天服务

多轮对话和会话管理是建立生产级聊天应用的主要能力。只是很多开发者在入门 Spring AI 时往往只实现了简单的单次问答，缺乏对上下文管理会话持久化流式输出等关键特性的

与效果展示

十、避坑教程与常用方法

十一、与

一、项目概述与技术选型

功能特性

特性 说明 多会话管理 支持创建、查询、删除多个独立会话 上下文记忆 自动携带历史消息，支持多轮对话 上下文截断 智能控制历史消息数量，防止 Token 超限 双模式输出 支持同步响应和 SSE 流式输出 响应式架构 全面使用 WebFlux + R2D娱乐。高并发友好 配置外部化 程序提示词、上下文长度等参数可配置

技术栈

技术 版本 用途 Spring Boot 3..10 基础框架 Spring AI 1.-SNAPSHOT AI 能力封装 Spring WebFlux 3..10 响应式 Web 框架 Spring Data R2D娱乐 3..10 响应式数据库访问 PostgreSQL 14+ 数据持久化 R2D娱乐 PostgreSQL - 响应式 PostgreSQL 驱动 Java 25+ 编程语言

架构设计

┌─────────────────────────────────────────────────────────────┐│ Client │└───────────────────────┬─────────────────────────────────────┘ │ HTTP/SSE┌───────────────────────▼─────────────────────────────────────┐│ ChatController ││ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ ││ │ POST /chat │ │POST /stream │ │ Session Management │ ││ └──────┬──────┘ └──────┬──────┘ └──────────┬──────────┘ │└─────────┼───────────────┼───────────────────┼──────────────┘ │ │ │┌─────────▼───────────────▼───────────────────▼──────────────┐│ ChatService ││ │└─────────┬───────────────────────┬──────────────────────────┘ │ │┌─────────▼──────────┐ ┌─────────▼──────────┐│ ChatClient │ │ R2D娱乐 Repository ││ │ │ │└─────────┬──────────┘ └─────────┬──────────┘ │ │┌─────────▼──────────┐ ┌─────────▼──────────┐│ OpenAI API │ │ PostgreSQL │
| | | |
└────────────────────┘
└────────────────────┘

二 、 环境准备

前置条件

. JDK . 或更高版本

. Maven +

. PostgreSQL + 数据库

. AI API Key

创建数据库

CREATE DATABASE chatdb;-- 创建使用者 CREATE USER chatuser WITH PASSWORD 'your_password';GRANT ALL PRIVILEGES ON DATABASE chatdb TO chatuser;按理说，

项目初始化

创建 Maven 项目。添加以下依赖：

<?xml version = "" encoding = "UTF-8"?> < project xmlns = "http://maven.apache.org/POM/." 至于xmlns，xsi = "http://www.w.org//XMLSchema-instance" 从xsi来看，schemaLocation = "http://maven.apache.org/POM/. http://maven.apache.org/xsd/maven-..xsd"> < modelVersion> . < groupId> org . example < artifactId> spring-ai-chat < version> -SNAPSHOT < properties> < maven . compiler . source> < maven . compiler . target> < project . build . sourceEncoding> UTF-8 < parent> < groupId> org . springframework . boot < artifactId> spring-boot-starter-parent < version> ..

spring-milestones Spring Milestones https://repo.spring.io/milestone false

...

三 、主要概念解析

在深入代码之前，先理解几个关键概念：

Spring AI 组件

组件	说明
ChatClient	AI 聊天的入口。封装了模型调用逻辑
Prompt	对象，包含完整的对话上下文
Message	单条消息

上下文长度控制策略

大模型有 Token，需要控制发送的历史消息数量：

说到策略，滑动窗口，保留最近 N

↓

四 、 项目结构搭建

src/main/java/org/example/ ├── SpringAiJcStart.java # 启动类 ├── config/ │ └── ChatProperties.java # 配置属性类

五 、 数据库设计与实体定义

数据库表结构

-- schema.sql

CREATE TABLE IF NOT EXISTS conversationsessions ( id BIGSERIAL PRIMARY KEY,title VARCHAR NOT NULL,createdat TIMESTAMP NOT NULL DEFAULT CURRENTTIMESTAMP,updatedat TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP );

会话实体

package org.example.entity;

import org.springframework.data.annotation.Id;不过，import org.springframework.data.relational.core.mapping.Column; import org.springframework.data.relational.core.mapping.Table;

Repository

import org.example.entity.ConversationSession;import org.springframework.data.repository.reactive.ReactiveCrudRepository;其实，import reactor.core.publisher.Flux;

/**

• 会话数据访问接口 */ public interface ConversationSessionRepository extends ReactiveCrudRepository &# xC;ConversationSession,Long> {

• 按更新时间倒序查询所有会话 */ Flux &# xC;按理说，ConversationSession> findAllByOrderByUpdatedAtDesc;

}

六 、 配置类与属性绑定

配置文件

从spring来看，ai: openai这方面，api-key: ${OPENAIAPIKEY:your-api-key-here} base-url: https://api.openai.com

... 说到app。chat: system-prompt: ""

配置属性类

import org.springframework.boot.context.properties.ConfigurationProperties;import org.springframework.context.annotation.Configuration;

• 聊天服务配置属性 */ @Configuration @ConfigurationProperties public class ChatProperties {

private String systemPrompt = "";

private int maxContextPairs =;

}}}

---