实际做智能社区服务管理系统这类毕业设计时,真正决定项目分数的不只是界面能跑通,而是业务是否完整、技术栈是否匹配、AI 功能能否在答辩现场稳定演示。基于 SpringBoot + Thymeleaf + AI 的智能社区服务管理系统,就是把住户管理、物业公告、报修工单、访客登记和缴费记录这些传统社区场景,整合到一套 Web 应用中,再通过大模型接口实现智能问答、办事引导和政策咨询。对于计算机相关专业的学生来说,这套组合的价值在于:SpringBoot 提供后端工程骨架,Thymeleaf 承担服务端页面渲染,AI 模块让项目具备当前招聘和答辩都比较看重的智能化亮点,而且每个部分都能独立讲解、独立测试。
本文按一个可复现的毕业设计项目来组织,从需求拆解、环境准备、数据库建模、工程搭建、核心模块实现,到 AI 助手接入、运行验证、常见问题排查和答辩准备,完整说明这套系统应该怎么落地。文章中的代码和配置以 SpringBoot 2.7.x + JDK 1.8 为基准,同时会说明选择这个版本的原因,以及升级到 SpringBoot 3.x 时需要改哪些地方。项目最终交付通常包含源码、设计论文(LW)、答辩 PPT 和讲解视频,本文也会在最后给出每个交付物应该重点写什么、讲什么。
1. 先理解智能社区服务管理系统要解决什么问题
1.1 核心业务范围
智能社区服务管理系统面向的是社区物业和业主两类用户。物业人员需要发布公告、处理业主提交的报修、审核访客申请、记录缴费信息;业主需要查看公告、提交报修、预约访客、查询缴费记录,遇到办事流程不清楚时能直接向系统提问。
如果只做简单的增删改查,项目在答辩时很容易被追问业务深度。建议至少划分出以下模块:
- 用户模块:业主、物业、管理员三类角色,登录注册、个人信息维护。
- 公告模块:物业发布社区通知,业主查看公告列表和详情。
- 报修模块:业主提交报修工单,物业处理并回填处理结果,状态可跟踪。
- 访客登记:业主登记来访人员信息,物业审核进出记录。
- 缴费记录:物业录入费用,业主查询历史账单。
- AI 服务助手:业主输入自然语言问题,系统返回社区办事流程、常见政策或引导到对应功能。
AI 服务助手是项目区别于普通 CRUD 系统的关键模块,也是论文中“创新点”和“系统特色”部分最值得展开的内容。
1.2 技术选型:为什么是 SpringBoot + Thymeleaf + AI
这个组合很适合毕业设计场景,原因有三点。
SpringBoot 是目前 Java 后端入门最友好的框架。它把 Tomcat、Spring MVC、数据源、事务等配置做了大量自动装配,学生不需要手动写一堆 XML 配置,就能把 Web 工程跑起来。同时 SpringBoot 也是企业招聘面试中的高频话题,选择它意味着论文技术背景部分有足够多内容可写。
Thymeleaf 是 SpringBoot 官方推荐的模板引擎,采用服务端渲染。页面数据由 Controller 通过 Model 传入,HTML 中通过
th:text
、
th:each
等属性渲染。相比前后端分离的 Vue 项目,Thymeleaf 少了跨域、Token 鉴权、CORS 配置这些额外概念,开发链路更短,更适合作为毕业设计的第一套完整 Web 项目。
AI 模块是大模型应用在垂直场景的典型实践。这里的“AI”不是要自己去训练模型,而是通过调用大模型 API,把用户问题和服务知识库组织成提示词,让模型以社区助手的角色返回答案。对毕业设计来说,这个思路既能规避训练成本,又能完整展示“大模型应用开发”的流程。
下表是三种页面技术路线在毕业设计场景下的对比:
| 技术路线 | 学习成本 | 答辩技术点 | 适用情况 |
|---|---|---|---|
| Thymeleaf 服务端渲染 | 低 | Spring MVC、模板引擎、Session 认证 | 快速完成全栈演示,适合时间紧的项目 |
| Vue 前后端分离 | 中高 | JWT、CORS、接口设计、前端构建 | 项目周期充足,想体现前后端分离能力 |
| 纯 JSP + Servlet | 低但偏旧 | 技术传统,难以体现新意 | 学校指定要求时使用 |
1.3 毕业设计的交付物边界
这类项目常见的完整交付清单包括四项:源码、论文(常简称为 LW)、答辩 PPT、讲解视频。源码负责可运行,论文负责解释设计过程和结果,PPT 负责在有限时间内呈现重点,讲解视频用于无法现场演示时的补充说明。
论文建议按“绪论、需求分析、系统设计、系统实现、系统测试、总结”的结构组织。其中系统设计要包含用例图、功能模块图、数据库 E-R 图和表结构说明;系统实现部分要写清楚关键技术点,例如登录拦截器如何工作、AI 请求报文如何组装、报修状态如何流转。测试部分不需要写大量页面截图,更值得写的是测试用例表、边界输入和异常场景的验证结果。
2. 环境准备与数据库建模
2.1 开发环境版本选择
版本选择是第一个容易踩坑的地方。搜索“SpringBoot 版本太高”出现的问题,绝大多数是 SpringBoot 3.x 与旧版依赖不兼容导致的。SpringBoot 3.x 要求 JDK 17 及以上,并且把
javax.servlet
迁移到了
jakarta.servlet
,如果项目里用了旧版本的 MyBatis-Plus、Shiro 或其它第三方库,直接升级会出现大量编译错误。
推荐按下面这套组合搭建:
| 组件 | 推荐版本 | 说明 |
|---|---|---|
| JDK | 1.8 或 17 | SpringBoot 2.7 建议用 JDK 1.8,3.x 必须用 17 |
| SpringBoot | 2.7.18 | 最后一个支持 JDK 1.8 的稳定线,生态兼容性最好 |
| MyBatis-Plus | 3.5.3.1 | 与 SpringBoot 2.7 兼容良好 |
| MySQL | 5.7 或 8.0 | 开发环境 5.7,生产环境建议 8.0 |
| Maven | 3.6.3 以上 | 版本过低可能导致依赖解析异常 |
| IDEA | 2022 及以上 | 支持 Lombok 插件和 Spring 工程初始化 |
这套组合的好处是资料多、报错少、网上解决方案丰富。如果学校明确要求新版本,再迁移到 SpringBoot 3.x,迁移重点就是
javax
到
jakarta
的包名替换,以及 MyBatis-Plus 使用适配新版本的
mybatis-plus-spring-boot3-starter
。
2.2 数据库表结构设计
数据库名建议使用
community_service
,统一使用
utf8mb4
字符集,避免中文乱码。核心表至少包括:用户表、公告表、报修工单表、访客登记表和 AI 问答记录表。
用户表设计如下:
CREATE TABLE sys_user (
id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键',
username VARCHAR(50) NOT NULL UNIQUE COMMENT '登录账号',
password VARCHAR(100) NOT NULL COMMENT '登录密码,加密后存储',
real_name VARCHAR(50) DEFAULT '' COMMENT '真实姓名',
phone VARCHAR(20) DEFAULT '' COMMENT '联系电话',
user_type TINYINT DEFAULT 0 COMMENT '用户类型:0 业主,1 物业,2 管理员',
avatar VARCHAR(255) DEFAULT '' COMMENT '头像地址',
create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统用户表';
报修工单表是业务核心,状态字段建议使用字符串枚举值,相比数字类型更直观:
CREATE TABLE repair_order (
id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '工单ID',
user_id BIGINT NOT NULL COMMENT '提交人ID',
title VARCHAR(100) NOT NULL COMMENT '报修标题',
content VARCHAR(500) DEFAULT '' COMMENT '问题描述',
address VARCHAR(200) DEFAULT '' COMMENT '维修地址',
status VARCHAR(20) DEFAULT 'PENDING' COMMENT '状态:PENDING待处理,PROCESSING处理中,DONE已完成,CANCELED已取消',
handler_id BIGINT DEFAULT NULL COMMENT '处理人ID',
handle_note VARCHAR(500) DEFAULT '' COMMENT '处理回执',
create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '提交时间',
handle_time DATETIME DEFAULT NULL COMMENT '处理时间'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报修工单表';
AI 问答记录表用于保存用户提问和模型回答,既能做历史记录展示,也能为论文中的“数据统计”提供素材:
CREATE TABLE ai_chat_log (
id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键',
user_id BIGINT NOT NULL COMMENT '提问用户ID',
question VARCHAR(500) NOT NULL COMMENT '用户问题',
answer TEXT COMMENT 'AI回答',
cost_ms BIGINT DEFAULT 0 COMMENT '接口耗时,单位毫秒',
create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '提问时间'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='AI问答记录表';
注意:表设计中不要把
password字段设计成明文存储。论文里如果写到“用户密码加密存储”,就要在实现中真的使用 BCrypt 或其它哈希算法,否则答辩时被追问代码会很难收场。
2.3 项目目录分层设计
建议采用常见的 Controller、Service、Mapper 三层结构,并在此基础上增加 vo 包用于接口返回对象、config 包用于配置类、interceptor 包用于拦截器:
community-service
├── src/main/java/com/community
│ ├── CommunityApplication.java
│ ├── config
│ │ ├── WebConfig.java
│ │ └── AiConfig.java
│ ├── controller
│ │ ├── LoginController.java
│ │ ├── AnnouncementController.java
│ │ ├── RepairController.java
│ │ ├── VisitorController.java
│ │ └── AiController.java
│ ├── service
│ │ ├── UserService.java
│ │ ├── RepairService.java
│ │ ├── AiChatService.java
│ │ └── ServiceQuestionService.java
│ ├── mapper
│ │ ├── UserMapper.java
│ │ ├── RepairMapper.java
│ │ └── AiChatLogMapper.java
│ ├── entity
│ │ ├── User.java
│ │ ├── Announcement.java
│ │ └── RepairOrder.java
│ ├── vo
│ │ └── Result.java
│ └── interceptor
│ └── LoginInterceptor.java
└── src/main/resources
├── application.yml
├── mapper
│ └── RepairMapper.xml
├── static
│ ├── css
│ └── js
└── templates
├── login.html
├── index.html
├── repair-list.html
└── ai-chat.html
分层设计不只是为了好看。论文里需要画“系统架构图”,分层结构可以直接对应绘制;答辩时被问到“一个请求从页面到数据库经过了哪些层”,也能按 Controller、Service、Mapper 的顺序讲清楚。
3. 搭建 SpringBoot + Thymeleaf 基础工程
3.1 创建工程并配置 pom.xml
使用 IDEA 的 Spring Initializr 创建工程时,Group 可以填
com.community
,Artifact 填
community-service
。依赖勾选 Spring Web、Thymeleaf、Lombok,再手动加入 MySQL 驱动和 MyBatis-Plus。
pom.xml 的核心依赖如下:
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.7.18</version>
<relativePath/>
</parent>
<properties>
<java.version>1.8</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-thymeleaf</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.3.1</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
</dependencies>
注意
mysql-connector-java
在 SpringBoot 2.7 中由父依赖统一管理,不需要写版本号。如果使用 SpringBoot 3.x,MySQL 驱动的坐标要改成
com.mysql:mysql-connector-j
。
3.2 application.yml 核心配置
在
src/main/resources/application.yml
中配置端口、数据源、Thymeleaf 和 AI 相关参数:
server:
port: 8080
servlet:
encoding:
charset: UTF-8
force: true
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/community_service?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false
username: root
password: root
thymeleaf:
cache: false
prefix: classpath:/templates/
suffix: .html
mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
map-underscore-to-camel-case: true
global-config:
db-config:
id-type: auto
ai:
endpoint: ${AI_ENDPOINT:https://api.example.com/v1/chat/completions}
api-key: ${AI_API_KEY:}
model: ${AI_MODEL:qwen-plus}
spring.thymeleaf.cache: false
是开发阶段必须保留的配置。如果设置成 true,修改 HTML 后需要重启应用才能看到变化,排查问题时非常浪费时间。
mybatis-plus.configuration.map-underscore-to-camel-case: true
可以让数据库的
create_time
自动映射到 Java 实体类的
createTime
字段,减少手写映射配置。
AI 参数使用
${AI_ENDPOINT:默认值}
的形式,目的是让 API 地址和密钥从环境变量读取,而不是硬编码在配置文件中。
3.3 用户登录与登录拦截器
登录功能是后续所有业务模块的前置条件。使用 Session 保存登录用户是最直接的方式,配合拦截器统一校验未登录请求。
UserServiceImpl 中校验登录的核心逻辑:
@Service
public class UserServiceImpl implements UserService {
@Resource
private UserMapper userMapper;
@Override
public User login(String username, String password) {
User user = userMapper.selectOne(new LambdaQueryWrapper<User>()
.eq(User::getUsername, username));
if (user != null && BCrypt.checkpw(password, user.getPassword())) {
return user;
}
return null;
}
}
密码使用
BCrypt
校验,注册时使用
BCrypt.hashpw(password, BCrypt.gensalt())
生成密文。这里不要使用自定义的 MD5 加盐方式,BCrypt 内置随机盐,是更被认可的做法。
登录 Controller:
@Controller
public class LoginController {
@Resource
private UserService userService;
@GetMapping("/login")
public String loginPage() {
return "login";
}
@PostMapping("/login")
public String doLogin(String username, String password, HttpSession session, Model model) {
User user = userService.login(username, password);
if (user == null) {
model.addAttribute("error", "账号或密码错误");
return "login";
}
session.setAttribute("loginUser", user);
return "redirect:/index";
}
@GetMapping("/logout")
public String logout(HttpSession session) {
session.invalidate();
return "redirect:/login";
}
}
登录拦截器:
@Component
public class LoginInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
if (request.getSession().getAttribute("loginUser") == null) {
response.sendRedirect("/login");
return false;
}
return true;
}
}
注册拦截器并排除登录、静态资源路径:
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Resource
private LoginInterceptor loginInterceptor;
@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(loginInterceptor)
.addPathPatterns("/**")
.excludePathPatterns("/login", "/register", "/css/**", "/js/**", "/images/**", "/error");
}
}
拦截器这一段必须写在论文里,并且要理解它的执行原理:
preHandle
在 Controller 方法执行前被调用,返回
false
时请求中断。拦截器在很多场景都有应用,比如权限校验、日志记录、接口耗时统计,答辩中被问到扩展性时可以这样回答。
4. 核心业务模块实现
4.1 公告模块:完整 CRUD 的标准写法
公告模块适合作为论文中的第一个完整功能案例,展示 Controller、Service、Mapper 的标准写法。
公告实体类:
@Data
@TableName("community_announcement")
public class Announcement {
@TableId(type = IdType.AUTO)
private Long id;
private String title;
private String content;
private Long createBy;
private LocalDateTime createTime;
}
公告 Controller:
@Controller
@RequestMapping("/announcement")
public class AnnouncementController {
@Resource
private AnnouncementService announcementService;
@GetMapping("/list")
public String list(Model model) {
model.addAttribute("announcements", announcementService.listLatest());
return "announcement-list";
}
@GetMapping("/detail/{id}")
public String detail(@PathVariable Long id, Model model) {
model.addAttribute("announcement", announcementService.getById(id));
return "announcement-detail";
}
}
Service 中的分页查询使用 MyBatis-Plus 的
Page
对象:
public Page<Announcement> pageList(int pageNum, int pageSize) {
Page<Announcement> page = new Page<>(pageNum, pageSize);
LambdaQueryWrapper<Announcement> wrapper = new LambdaQueryWrapper<>();
wrapper.orderByDesc(Announcement::getCreateTime);
return announcementMapper.selectPage(page, wrapper);
}
这里要理解
LambdaQueryWrapper
的两个优点:第一,通过方法引用直接指定字段,避免字符串拼写错误;第二,类型安全,重构字段名时编译器能直接发现错误。
4.2 报修工单:状态流转与权限控制
报修工单是业务流程最完整的模块。业主提交工单后状态为
PENDING
,物业人员把状态改为
PROCESSING
,处理完成时填写处理回执并置为
DONE
,业主也可以取消
PENDING
状态的工单。
报修状态流转逻辑:
@Service
public class RepairServiceImpl implements RepairService {
@Resource
private RepairMapper repairMapper;
@Override
public boolean updateStatus(Long orderId, String targetStatus, User operator, String handleNote) {
RepairOrder order = repairMapper.selectById(orderId);
if (order == null) {
return false;
}
// 普通业主只能取消自己的 PENDING 工单
if ("CANCELED".equals(targetStatus)) {
if (!order.getUserId().equals(operator.getId())) {
throw new BusinessException("只能取消自己的报修单");
}
if (!"PENDING".equals(order.getStatus())) {
throw new BusinessException("当前状态不允许取消");
}
}
// 物业和管理员才能进入处理环节
if ("PROCESSING".equals(targetStatus) || "DONE".equals(targetStatus)) {
if (operator.getUserType() == 0) {
throw new BusinessException("业主不能执行该操作");
}
}
order.setStatus(targetStatus);
order.setHandlerId(operator.getId());
order.setHandleNote(handleNote);
order.setHandleTime(LocalDateTime.now());
return repairMapper.updateById(order) > 0;
}
}
业务规则写在 Service 而不是 Controller,是这套项目的关键设计。答辩时如果被问到“为什么 Controller 里没有业务代码”,可以直接回答:Controller 负责参数接收和视图跳转,业务规则和权限判断放到 Service 层,一方面便于复用,另一方面也方便编写单元测试。
这里建议引入统一的业务异常类
BusinessException
,配合全局异常处理器返回友好提示,而不是在 Controller 里写大量
if/else
。
4.3 AI 服务助手:大模型接口的通用调用方式
AI 模块是项目的技术亮点。实现思路是:业主访问 AI 助手页面,输入自然语言问题;后端收到问题后,先做常见问题匹配,命中则直接返回预设答案,未命中则调用大模型 API。
这样做的好处很明显:常见问题不走模型接口,响应快且零成本;同时避免了大模型接口不可用时整个页面不可用的问题。
先定义统一响应类:
@Data
public class Result {
private Integer code;
private String message;
private Object data;
public static Result ok(Object data) {
Result result = new Result();
result.setCode(200);
result.setMessage("success");
result.setData(data);
return result;
}
public static Result error(String message) {
Result result = new Result();
result.setCode(500);
result.setMessage(message);
return result;
}
}
AiChatService 使用 RestTemplate 调用大模型接口。这里以当前大模型平台通用的
chat/completions
接口格式为例,实际项目需要根据所选平台调整请求地址和字段:
@Service
@Slf4j
public class AiChatService {
private final RestTemplate restTemplate;
@Value("${ai.endpoint}")
private String endpoint;
@Value("${ai.api-key}")
private String apiKey;
@Value("${ai.model}")
private String model;
private static final int CONNECT_TIMEOUT = 5000;
private static final int READ_TIMEOUT = 30000;
public AiChatService() {
SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
factory.setConnectTimeout(CONNECT_TIMEOUT);
factory.setReadTimeout(READ_TIMEOUT);
this.restTemplate = new RestTemplate(factory);
}
private Map<String, Object> buildMessage(String role, String content) {
Map<String, Object> message = new HashMap<>();
message.put("role", role);
message.put("content", content);
return message;
}
public String chat(String userMessage, String systemPrompt) {
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
headers.setBearerAuth(apiKey);
Map<String, Object> payload = new HashMap<>();
payload.put("model", model);
payload.put("messages", Arrays.asList(
buildMessage("system", systemPrompt),
buildMessage("user", userMessage)
));
payload.put("temperature", 0.7);
HttpEntity<Map<String, Object>> request = new HttpEntity<>(payload, headers);
try {
ResponseEntity<Map> response = restTemplate.exchange(
endpoint, HttpMethod.POST, request, Map.class);
if (response.getStatusCode().is2xxSuccessful() && response.getBody() != null) {
Map body = response.getBody();
List choices = (List) body.get("choices");
if (choices != null && !choices.isEmpty()) {
Map firstChoice = (Map) choices.get(0);
Map message = (Map) firstChoice.get("message");
return String.valueOf(message.get("content"));
}
}
} catch (Exception e) {
log.error("AI 接口调用失败,endpoint={}", endpoint, e);
}
return "AI 服务暂时不可用,请稍后再试。";
}
}
这个实现里有几个必须理解的点:
-
setConnectTimeout(5000)控制建立连接的超时时间,setReadTimeout(30000)控制等待模型返回的最长时间。大模型生成回答通常需要几秒到几十秒,读超时不能设置太短。 -
headers.setBearerAuth(apiKey)是多数大模型平台的标准认证方式,也有平台使用Authorization: Bearer之外的格式,需要按平台文档调整。 -
temperature参数控制回答的随机性,值越小输出越稳定,做客服助手建议设置在 0.3 到 0.7 之间。
4.4 提示词设计与常见问题匹配
AI 助手的表现不只取决于模型,更取决于系统提示词。系统提示词的作用是给模型设定角色、边界和输出规范。
String systemPrompt = "你是智能社区服务系统的 AI 助手。你可以回答与社区生活相关的问题,"
+ "包括物业报修流程、访客登记、缴费查询、社区公告、常见政策等。"
+ "回答要简洁、准确、口语化。如果用户的问题不在你的知识范围内,"
+ "请引导用户联系物业服务中心,不要编造政策信息。";
提示词设计有三个要点:
- 明确角色定位:告诉模型“你是社区助手”,比直接让模型回答通用问题效果更好。
- 限定回答范围:避免模型输出与社区无关甚至违规的信息。
- 规定兜底策略:不知道就引导联系人工,而不是编造内容。
在调用大模型之前,可以先用关键词匹配常见问题表。例如用户输入“怎么报修”,系统先查
service_question
表,找到匹配度高的问题后直接返回预设答案。这样既节省接口调用成本,也能保证高频问题在演示时稳定秒回。
AiController 完整逻辑:
@Controller
@RequestMapping("/ai")
public class AiController {
@Resource
private AiChatService aiChatService;
@Resource
private AiChatLogService aiChatLogService;
@GetMapping("/chat")
public String chatPage() {
return "ai-chat";
}
@PostMapping("/chat")
@ResponseBody
public Result chat(@RequestParam("message") String message, HttpSession session) {
User user = (User) session.getAttribute("loginUser");
if (message == null || message.trim().isEmpty()) {
return Result.error("请输入问题");
}
if (message.length() > 200) {
return Result.error("问题长度不能超过200字");
}
long start = System.currentTimeMillis();
String answer = aiChatService.chatWithKnowledge(user.getId(), message.trim());
long cost = System.currentTimeMillis() - start;
aiChatLogService.saveLog(user.getId(), message.trim(), answer, cost);
return Result.ok(answer);
}
}
在
AiChatService
中补充常见问题匹配逻辑:
public String chatWithKnowledge(Long userId, String message) {
String answer = questionService.matchByKeyword(message);
if (answer != null) {
return answer;
}
return chat(message, buildSystemPrompt());
}
这样 AI 模块就有了“本地规则兜底 + 大模型智能生成”的完整链路,论文里可以起名为“基于知识库缓存与大模型生成的混合式问答策略”,比单纯调用接口更有设计感。
5. Thymeleaf 页面集成
5.1 页面布局与公共片段
Thymeleaf 支持通过
th:fragment
抽取公共页面片段,例如导航栏和页脚。创建一个
layout.html
:
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<header th:fragment="navbar">
<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
<a class="navbar-brand" th:href="@{/index}">智能社区服务管理系统</a>
<div class="navbar-nav">
<a class="nav-link" th:href="@{/announcement/list}">社区公告</a>
<a class="nav-link" th:href="@{/repair/list}">报修管理</a>
<a class="nav-link" th:href="@{/visitor/list}">访客登记</a>
<a class="nav-link" th:href="@{/ai/chat}">AI 助手</a>
</div>
</nav>
</header>
</html>
业务页面通过
th:replace
引入公共片段:
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>AI 助手</title>
<link rel="stylesheet" th:href="@{/css/bootstrap.min.css}">
</head>
<body>
<div th:replace="layout :: navbar"></div>
<div class="container mt-4">
<h4>智能社区服务助手</h4>
<div id="chatBox" class="border rounded p-3" style="min-height: 400px;"></div>
<textarea id="message" class="form-control mt-2" rows="3" placeholder="请输入您的问题,例如:如何报修水电问题?"></textarea>
<button id="sendBtn" class="btn btn-primary mt-2" onclick="sendMessage()">发送</button>
</div>
<script th:src="@{/js/ai-chat.js}"></script>
</body>
</html>
5.2 列表页与表单提交
公告列表页使用
th:each
遍历数据:
<table class="table table-hover">
<thead>
<tr>
<th>标题</th>
<th>发布时间</th>
<th>操作</th>
</tr>
</thead>
<tbody>
<tr th:each="announcement : ${announcements}">
<td th:text="${announcement.title}">公告标题</td>
<td th:text="${#temporals.format(announcement.createTime, 'yyyy-MM-dd HH:mm')}">2025-01-01 10:00</td>
<td>
<a th:href="@{/announcement/detail/{id}(id=${announcement.id})}">查看详情</a>
</td>
</tr>
</tbody>
</table>
th:href="@{/announcement/detail/{id}(id=${announcement.id})}"
是 Thymeleaf 的 URL 表达式写法,会自动做路径参数拼接和 URL 编码,不要在 HTML 里手动拼字符串。
表单提交要注意 CSRF 问题。Spring Security 默认开启 CSRF 防御,但本项目的简单拦截器方案并没有引入 Spring Security,所以表单里不需要额外添加
_csrf
字段。如果后续接入 Spring Security,所有
POST
表单必须加入隐藏的 CSRF Token,否则会报 403。
5.3 AI 助手页面的异步请求
AI 页面适合使用 JavaScript 的
fetch
发送异步请求,避免整个页面刷新。新建
static/js/ai-chat.js
:
async function sendMessage() {
const input = document.getElementById('message');
const message = input.value.trim();
if (!message) {
return;
}
const chatBox = document.getElementById('chatBox');
chatBox.innerHTML += '<div class="alert alert-secondary">用户:' + escapeHtml(message) + '</div>';
input.value = '';
try {
const response = await fetch('/ai/chat', {
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'
},
body: new URLSearchParams({message: message})
});
const data = await response.json();
const answer = data.code === 200 ? data.data : data.message;
chatBox.innerHTML += '<div class="alert alert-primary">AI 助手:' + escapeHtml(answer) + '</div>';
} catch (error) {
chatBox.innerHTML += '<div class="alert alert-danger">请求失败,请检查网络或稍后再试。</div>';
}
chatBox.scrollTop = chatBox.scrollHeight;
}
function escapeHtml(text) {
const div = document.createElement('div');
div.appendChild(document.createTextNode(text));
return div.innerHTML;
}
这里使用
escapeHtml
对用户输入和模型输出做 HTML 转义,防止 XSS 注入。这是很多毕业设计容易忽略的点,写到论文的安全设计部分很有说服力。
6. 运行验证与功能测试
6.1 启动步骤
按以下顺序启动项目:
-
在 MySQL 中执行数据库初始化脚本,创建
community_service库和所有表。 - 在 IDEA 中导入 Maven 工程,等待依赖下载完成。
-
修改
application.yml中的数据库用户名和密码。 -
运行
CommunityApplication主类。 -
浏览器访问
http://localhost:8080/login,使用初始化管理员账号登录。
如果需要打包部署,使用 Maven 命令:
mvn clean package -DskipTests
生成的 jar 包位于
target/community-service-0.0.1-SNAPSHOT.jar
,运行命令:
java -jar target/community-service-0.0.1-SNAPSHOT.jar
启动成功后在控制台会看到 Tomcat 启动日志。访问
http://localhost:8080/login
能看到登录页,说明工程骨架正常。
6.2 功能验证清单
验收时建议按下面的清单逐项测试,每项都记录实际结果和截图,作为论文测试章节的材料:
| 功能模块 | 测试步骤 | 预期结果 |
|---|---|---|
| 登录认证 | 输入正确账号密码 | 跳转首页,Session 保存用户信息 |
| 登录失败 | 输入错误密码 | 停留登录页并显示错误提示 |
| 未登录拦截 |
直接访问
/repair/list
| 重定向到登录页 |
| 公告发布 | 物业账号新增公告 | 列表页出现新公告 |
| 报修提交 | 业主账号提交报修工单 | 工单状态为 PENDING |
| 报修处理 | 物业账号处理工单 | 状态变为 DONE,填写处理回执 |
| 权限控制 | 业主账号尝试处理他人工单 | 提示无权操作 |
| AI 常见问题 | 输入“如何报修” | 秒回预设答案 |
| AI 模型调用 | 输入“社区最近有什么活动” | 返回模型生成内容 |
| AI 接口异常 | 关闭 AI 配置或断网 | 返回友好提示,页面不崩溃 |
实际验收不能只看“页面能打开”,还要验证异常分支。答辩演示时最怕的就是 AI 接口突然超时或报错,提前把异常场景测试清楚,演示过程才会稳定。
7. 常见问题与排查
毕业设计开发过程中最常遇到的问题集中在版本、配置、AI 接口三个方向。下面按“现象、原因、检查、解决”的顺序整理。
| 问题现象 | 常见原因 | 检查方式 | 解决方案 |
|---|---|---|---|
项目启动报
ClassNotFoundException: javax.servlet.*
| SpringBoot 3.x 下依赖仍引用旧版包 | 查看 pom 中 SpringBoot 版本和第三方依赖版本 |
降级到 SpringBoot 2.7.x,或把
javax
改为
jakarta
|
| 页面修改后刷新不生效 | Thymeleaf 缓存未关闭或浏览器缓存 |
检查
spring.thymeleaf.cache
|
开发环境设为
false
,强制刷新浏览器
|
| 登录时中文用户名乱码 | 数据库字符集或请求编码配置错误 |
检查库表字符集、
server.servlet.encoding
|
创建库时使用
utf8mb4
,配置编码过滤器
|
| MyBatis-Plus 查询不到数据 | 表名与实体名映射不一致 | 查看控制台 SQL 日志 |
添加
@TableName
注解或配置
table-prefix
|
| AI 接口调用超时 | RestTemplate 未设置超时时间 | 观察接口耗时和异常堆栈 | 设置连接超时和读超时,增加 try/catch |
| AI 返回内容包含多余格式 | 响应结构解析不正确 | 打印完整响应 JSON |
按平台文档解析
choices[0].message.content
|
| 控制台 SQL 不显示 | MyBatis-Plus 日志未开启 |
检查
application.yml
|
配置
log-impl: StdOutImpl
|
版本兼容问题需要单独强调。如果项目一开始就选择了较新的 SpringBoot 3.3、3.4,而 MyBatis-Plus、Shiro、FastJSON 等依赖没有同步升级,运行期会出现各种奇怪的错误。建议固定使用一套经过验证的版本组合,不要盲目追新。
AI 接口排错按这个顺序执行:
-
确认配置项是否生效:在启动日志中搜索
ai.endpoint、ai.api-key,确认是从配置文件中读取还是在环境变量中注入。 - 确认网络连通性:用 curl 直接测试接口地址,确认能否返回响应。
-
确认请求报文:把
payload打印出来,检查模型名称、消息格式是否符合平台要求。 - 确认响应解析:接口可能返回 200 但结构不是预期格式,打印完整响应体定位问题。
- 确认超时设置:模型生成内容较长时,读超时 30 秒可能仍然不够,需要结合实际情况调整。
8. 毕业设计规范与实践建议
8.1 答辩环节最该准备的技术点
答辩时评委通常不会逐行读代码,而是围绕几个关键点提问:
- 项目整体架构:画清楚“浏览器 → Controller → Service → Mapper → MySQL”的请求链路,说明每个层的作用。
- 登录认证原理:解释 Session 会话保持机制、拦截器如何拦截未登录请求、为什么不用 JWT。
- 数据库设计:说明用户表、报修表、AI 日志表之间的关联关系,以及状态字段为什么用字符串枚举。
- AI 模块实现:讲清楚提示词设计、接口调用、超时和降级策略。这是项目最有可能出彩的部分。
- 项目可以改进的方向:提前准备两三个扩展点,比如引入工作流引擎 Flowable 处理报修审批流、使用 WebSocket 实现处理状态实时推送、将服务端渲染升级为前后端分离。
答辩 PPT 建议控制在 15 到 20 页,重点放需求分析、架构设计、核心功能截图、AI 模块链路图和测试结果。不要贴大段代码,评委关心的是你能否讲清楚设计思路,而不是代码数量。
8.2 从学习项目到生产项目的差距
如果只是完成毕业设计,现有实现已经足够。但如果想把这个项目写成简历项目,或者后续作为个人作品继续发展,以下几点必须补上:
- 配置外置化:数据库密码、AI 密钥通过环境变量或配置中心管理,不能出现在仓库里。
- 日志与监控:使用 Logback 输出结构化日志,记录接口耗时和错误堆栈;生产环境接入监控看板。
-
统一异常处理:使用
@RestControllerAdvice处理业务异常和系统异常,避免页面暴露堆栈信息。 - 接口限流:AI 接口有成本,需要按用户或 IP 限制调用频率,避免被恶意刷接口。
- 数据脱敏:用户手机号、身份证号在列表中脱敏展示。
- 系统备份:数据库定期备份,部署服务器做好回滚方案。
8.3 扩展方向建议
这个项目可以沿着三条路线扩展。
路线一是把 AI 能力做深。当前实现是“一问一答”的单轮对话,可以扩展为多轮会话,让模型记住上下文;或者使用 RAG(检索增强生成)方案,把社区政策文档、物业条款向量化后存储到向量数据库,用户提问时先检索相关段落再交给模型生成,回答的准确性和可解释性都会明显提升。
路线二是把业务流程做重。报修工单目前只有简单的状态流转,可以引入 Flowable 工作流引擎,设计工单提交、派单、处理、验收、超时提醒的完整审批流程。这是企业级系统常见的需求,写到简历上比纯粹的 CRUD 更有分量。
路线三是做前后端分离升级。把 Thymeleaf 页面替换为 Vue 3 前端工程,后端提供 REST API,登录改为 JWT 认证。这个方向需要额外处理跨域、Token 刷新、前端路由守卫等问题,适合项目周期充足的情况。
对学习价值而言,建议把 AI 模块的链路吃透:用户输入如何预处理、本地知识库如何匹配、请求如何组装、超时如何处理、日志如何记录、失败如何降级。这条链路包含了大模型应用开发的通用思维,学会了它,不管是换一个模型平台,还是换一个业务场景,都能快速迁移。
578



被折叠的 条评论
为什么被折叠?



