简介一套基于SpringBoot的大学生心理咨询系统完整源码项目面向计算机相关专业毕业设计、实训及全栈开发学习者。项目采用前后端分离架构后端以Java/SpringBoot为核心前端包含大量JavaScript、HTML、CSS及图表组件文件并配套SQL数据库脚本、Maven配置与构建脚本可用于快速搭建心理测评、预约咨询、信息管理等典型功能流程。源码已通过本地编译测试按文档配置环境即可运行适合作为课设模板或二次开发基础。压缩包共3978个文件大小约16.39MB主要以JS、PNG、CSS、HTML、Java等类型构成目录结构清晰。目前已有293人学习下载项目难度适中内容经助教审定能够帮助使用者理解前后端联调掌握SpringBoot与MySQL的整合开发思路同时减少环境踩坑时间是提升全栈实践能力的实用参考。1. 用SpringBoot重构校园心理咨询这个毕设题到底在做什么高校心理咨询中心最头疼的往往不是咨询本身而是“约得上”和“记得住”。预约靠人工排表时咨询师的空档和学生的时间互相看不见放号几分钟就被抢完测评结果散落在纸质问卷里咨询师下次接待时看不到历史分数变化来访记录放在不同老师的电脑里没法汇总分析。基于SpringBoot的大学生心理咨询系统就是把这三条线下流程拆成预约管理、心理测评、咨询记录三个闭环再交给一台服务器统一处理。做这个题的人通常不是技术新手就是时间紧张的应届生所以整套方案要实用、能答辩、能演示。这篇内容会顺着这个标题把需求拆开把表设计出来再给出Login、预约、测评计分三块核心代码最后补上并发冲突和数据泄露两个最容易在答辩现场翻车的点。2. 从需求到表结构SpringBoot心理咨询系统的角色、流程与数据设计2.1 为什么选SpringBoot而不是其它框架这个系统本质上是典型的管理信息系统核心操作就是增删改查、状态流转和角色权限但它比普通的图书管理系统多一个硬约束预约不能冲突。SpringBoot在这个场景下的优势不在“开发快”三个字而在于它把配置、部署、测试三条线都压短了。内嵌Tomcat意味着打包成一个jar就能跑不需要在答辩现场配置外部容器自动装配虽然屏蔽了细节但分层架构依然保留Controller、Service、Mapper各司其职答辩老师问起来你能讲清楚每一层在干什么。生态上MyBatis-Plus处理单表CRUD非常顺手JWT做无状态登录比Session更适合前后端分离Redis缓存测评量表题目能减少数据库压力这些组件全部靠starter引入版本由SpringBoot统一管理不会出现依赖打架的问题。常见做法是SpringBoot 2.7.x MyBatis-Plus 3.5.x MySQL 8.0 JWT这套组合稳定且资料多。如果你用的是JDK 17甚至21建议先试试SpringBoot 2.7系列它能兼容到JDK 17SpringBoot 3.x要求jakarta命名空间很多老教程直接失效除非有明确理由毕业设计阶段没必要给自己加这个难度。2.2 角色权限拆解与业务流程这个题目涉及三类角色权限边界必须从一开始就分清。学生来访者能注册登录、查看咨询师列表、提交预约、填写心理测评量表、查看自己的测评报告和预约记录。咨询师能设置可预约时段、查看分配给自己的预约、填写咨询记录、查看来访者的历史测评摘要。管理员负责审核咨询师账号、管理公告、查看预约统计数据和测评完成率。角色核心操作数据权限范围学生预约、测评、查看报告只能看到自己的预约和测评咨询师排班、接单、填记录只能看到分配给自己的来访者管理员审核、统计、公告全量数据可读但咨询记录建议脱敏显示预约流程是核心链路学生浏览咨询师列表选择一个空闲时间段提交预约系统校验该时间段是否已被占用状态从“待确认”变为“已预约”咨询师可确认或取消。测评流程独立但数据关联学生填写量表系统实时计算总分和分量表得分写入测评结果表同一量表允许多次填写但只在咨询师查看时展示最近一次结果。2.3 核心表的字段设计与建表SQL按上面拆解至少需要六张核心表用户表sys_user、咨询师信息表counselor、预约表appointment、量表表scale、题目表scale_question、测评记录表assessment_result外加咨询记录表counsel_record用于留存咨询师每次接待的文本记录。这里只说三张最容易设计错的表。预约表是重中之重不要只存时间字符串要拆成start_time和end_time两个datetime字段。状态字段用tinyint0待确认、1已确认、2已完成、3已取消。关键设计是给counselor_id、start_time、status建联合唯一索引用数据库兜底同一咨询师同一开始时间只能有一条未取消记录。下面是最小建表语句CREATE TABLE appointment ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL, counselor_id BIGINT NOT NULL, start_time DATETIME NOT NULL, end_time DATETIME NOT NULL, status TINYINT NOT NULL DEFAULT 0, content VARCHAR(500) DEFAULT NULL, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_counselor_start (counselor_id, start_time, status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意这里唯一索引带status是双刃剑。如果预约被取消status变为3新预约插入时status为0索引检查的是不同组合所以取消后的同一时间可以被重新预约。但如果两个请求同时以status0插入同一时间段MySQL会拒绝后插入的那个这就挡住了最直接的并发冲突。外键不建议建逻辑关联足够物理外键在删除用户或咨询师时会造成大量级联操作在线系统一般不用。测评结果表需要记录量表ID、用户ID、总分以及每个分量表的分数。维度分数最好用单独的逗号分隔字符串存一个字段配合另一个字段存维度名称避免为每个维度建列导致表结构僵化。查询时拆开渲染即可答辩演示时比多表关联来得直观。2.4 后端包结构与代码分层约定包结构按com.school.psy为根包下面分controller、service、mapper、entity、dto、config、common七个子包。entity放数据库映射实体dto放前端传入的请求参数和返回给前端的响应对象二者分离是为了不让数据库字段直接暴露给前端比如用户密码哈希绝不能出现在实体返回里。service层做业务校验和事务控制controller层只做参数接收和结果封装这个分层规则要守住答辩时老师大概率会问“为什么预约校验放在service而不是controller”。com.school.psy ├── controller # 接收HTTP请求做参数绑定 ├── service # 业务逻辑事务边界 ├── mapper # MyBatis-Plus的Mapper接口 ├── entity # 数据库实体 ├── dto # 请求/响应对象 ├── config # 拦截器、CORS、MyBatis-Plus配置 └── common # 统一返回、异常处理、常量类实际编码过程中最容易乱的是dto和entity混用。很多项目图省事直接用entity接收前端参数最后在接口文档里暴露了所有字段安全隐患不小。建议每个接口单独定义dto虽然代码量多一点但答辩时“接口隔离”这个点能加分。3. SpringBoot MyBatis-Plus的最小实现登录、预约与测评计分3.1 基于JWT的登录态设计与拦截器配置用户登录用BCrypt存储密码哈希密码校验通过后生成JWT令牌。JWT本身不保存服务端状态适合前后端分离部署但要注意两个细节令牌过期时间不能太长建议2小时注销登录时单纯丢弃令牌不可靠常见做法是加一个Redis黑名单把注销的jti存进去拦截器校验时先查黑名单。这里选JWT而不是Spring Security是因为这个系统的角色只有三种用拦截器加注解足以表达权限规则引入Security框架反而增加配置复杂度。Service public class AuthService { Autowired private SysUserMapper userMapper; Autowired private StringRedisTemplate redisTemplate; public String login(String username, String rawPassword) { SysUser user userMapper.selectOne( new LambdaQueryWrapperSysUser() .eq(SysUser::getUsername, username)); if (user null || !BCrypt.checkpw(rawPassword, user.getPassword())) { throw new BusinessException(用户名或密码错误); } String token Jwts.builder() .setSubject(user.getId().toString()) .claim(role, user.getRole()) .setExpiration(new Date(System.currentTimeMillis() 7200000)) .signWith(SignatureAlgorithm.HS256, jwtSecret) .compact(); return token; } }这段代码里BCrypt.checkpw是恒定时间比较比equals安全。setExpiration明确了两小时过期时间claim里塞了role拦截器可以直接解析角色不用再查一次数据库。注意jwtSecret要放到配置文件里不能硬编码在类中。拦截器要做两层校验先通过JWT解析器验证签名和有效期再检查当前用户角色是否匹配目标接口要求的角色。HandlerInterceptor的preHandle返回false时要写入统一的JSON错误响应而不是直接返回401空页面。3.2 预约接口时间冲突判断与事务控制预约是这个系统里唯一需要严谨考虑并发的业务。一个咨询师的可预约时间段可能只有上午两个、下午三个两个学生同时点同一个时间段如果代码只查数据库“是否有记录”两个请求可能都查到没有记录然后都执行插入导致重复预约。代码层面要做两件事用重叠区间条件更新咨询师排班表记录的状态再插入预约记录整体加事务。Transactional public void createAppointment(AppointmentDTO dto) { LocalDateTime start dto.getStartTime(); LocalDateTime end dto.getEndTime(); if (!start.isBefore(end)) { throw new BusinessException(开始时间必须早于结束时间); } // 关键更新排班记录CAS思想status1表示该时段空闲 int updated counselorScheduleMapper.update(null, new LambdaUpdateWrapperCounselorSchedule() .set(CounselorSchedule::getStatus, 1) .eq(CounselorSchedule::getCounselorId, dto.getCounselorId()) .eq(CounselorSchedule::getStartTime, start) .eq(CounselorSchedule::getEndTime, end) .eq(CounselorSchedule::getStatus, 0)); if (updated 0) { throw new BusinessException(该时段已被预约请选择其他时间); } // 排班更新成功才插入预约记录 Appointment appointment new Appointment(); appointment.setStudentId(dto.getStudentId()); appointment.setCounselorId(dto.getCounselorId()); appointment.setStartTime(start); appointment.setEndTime(end); appointment.setStatus(0); appointmentMapper.insert(appointment); }这段代码有两点值得在答辩时重点解释。update语句带四个条件其中eq(status, 0)是关键——它保证只有原本空闲的记录能被置为占用MySQL的行锁和条件更新让并发请求只有一个能更新成功updated为0的请求直接抛异常。Transactional保证排班表更新和预约表插入要么都成功要么都回滚不会出现排班被占但预约没插上。这个方案比先查询再插入更加可靠因为它把“检查并执行”合并成一个原子操作。时间参数校验也不能省只校验开始时间早于结束时间不够还应检查是否在咨询师设置的开放时段范围内。建议在dto里加Future注解校验开始时间不在过去Spring的Valid会自动触发这个检查。3.3 测评量表计分总分与分量表的动态计算量表题目结构通常是题目表存题干和选项选项值可能是0分到3分部分量表还按维度分组比如抑郁量表分情绪、认知、行为三个维度。计分逻辑要把选项值和题目维度关联起来循环遍历用户提交的答案累加总分和每个维度的分数。用Map保存维度累加值既灵活又不需要预先知道维度数量。public AssessmentResultVO calcScore(Long scaleId, MapLong, Integer answers) { ListScaleQuestion questions scaleQuestionMapper.selectList( new LambdaQueryWrapperScaleQuestion() .eq(ScaleQuestion::getScaleId, scaleId)); int totalScore 0; MapString, Integer dimScore new HashMap(); for (ScaleQuestion q : questions) { Integer answer answers.get(q.getId()); if (answer null) { throw new BusinessException(题目 q.getId() 未作答); } totalScore answer; int dimVal dimScore.getOrDefault(q.getDimension(), 0); dimScore.put(q.getDimension(), dimVal answer); } AssessmentResult result new AssessmentResult(); result.setUserId(currentUserId()); result.setScaleId(scaleId); result.setTotalScore(totalScore); result.setDimensionScores(dimScore.toString()); // 写入测评记录并解析结果等级 return interpretResult(result); }这里Map的key是维度名称value是该维度累加分数toString之后存入数据库的单列字段读取时用JSON反序列化还原。注意答案集合用题目ID作为key是标准做法前端提交时必须回传题目ID否则后端无法定位题目。如果某个量表存在反向计分的题目需要在ScaleQuestion表加一个reverse字段计分时用选项数减一减去当前值。4. 配置与参数调优SpringBoot层面对并发预约和数据安全的处理4.1 application.yml 中的关键配置项与版本选择配置文件按环境拆成application.yml公共、application-dev.yml开发、application-prod.yml演示或部署公共配置放端口、JWT密钥、序列化规则环境配置放数据源和Redis地址。这里给出一个带注释的最小骨架server: port: 8080 tomcat: max-threads: 200 min-spare-threads: 20 accept-count: 100 spring: datasource: url: jdbc:mysql://localhost:3306/psy_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: ${DB_PASSWORD:root} hikari: maximum-pool-size: 10 minimum-idle: 5 redis: host: localhost port: 6379 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: Asia/Shanghai mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 jwt: secret: ${JWT_SECRET:f3a1c2d4e5b6a7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b} expire-hours: 2配置项推荐值作用与坑server.tomcat.accept-count100等待队列长度预约瞬间高并发时不丢请求spring.datasource.hikari.maximum-pool-size10连接池过大反而拖慢10够用mybatis-plus.log-implStdOutImpl开发时打印SQL部署前务必关掉spring.jackson.date-formatyyyy-MM-dd HH:mm:ss不配的话前端拿到的LocalDateTime是数组格式jwt.secret环境变量注入硬编码到yml里会被人扫仓库拿到密钥连接池参数值得多提一句。预约类系统典型场景是短平快的SQL连接池大小不用设置很大10个连接足以支撑几百人同时在线预约反而过大连接数会让MySQL线程切换变严重。如果演示现场出现“请求排队”现象优先看accept-count是否被默认值限制再考虑调大max-threads。4.2 SpringBoot版本过高导致的三个典型坑“springboot版本太高”这个词条经常出现在检索日志里这个项目同样会碰到。如果用SpringBoot 3.0以上有几个坑必须提前知道javax.servlet变成jakarta.servlet所有老代码里的import javax要批量替换spring.factories被废弃自定义starter改用了AutoConfiguration.imports文件MyBatis-Plus要升到3.5.3以上才有对应的spring-boot3-starter。如果教程是2022年之前的几乎全部失效。建议直接固定SpringBoot 2.7.18这是2.x系列的最终维护版本资料最多兼容JDK 8到17做毕设完全够用。还有一类高版本坑是JWT的依赖之前常用的jjwt 0.9.x在JDK 11以上会报模块访问错误换成jjwt 0.11.5后要改用Jwts.builder().signWith(SecretKey)的写法不能再传String密钥。4.3 Actuator端点泄露与HeapDump安全加固在线系统一旦把spring-boot-starter-actuator不加配置地引入就相当于对外暴露了内部运行状态。尤其http://服务器IP:8080/actuator/heapdump能直接把JVM堆内存下载下来堆里有JWT密钥、数据库密码、用户数据这个泄露在实习和正式项目里都是高级漏洞。SpringBoot 2.x默认只开放health端点但很多人为了演示方便把management.endpoints.web.exposure.include设为*这就是把底裤亮给整个公网。修复方案很简单management: endpoints: web: exposure: include: health,info endpoint: health: show-details: never如果确实需要看metrics或heapdump把management.server.port改成和主端口不同的内网端口再通过防火墙限制来源IP。答辩演示前检查一下actuator页面的访问情况非常必要。另一个容易被忽略的点是SpringBoot的error页面会打印堆栈信息如果异常处理不当数据库表名和字段名可能直接出现在响应里。统一异常处理类里要保证返回给前端的信息不包含SQL异常原文。4.4 敏感数据存储配置密文与密码字段处理基本信息配置里的数据库密码和JWT密钥不应该以明文出现在yml里推荐用Jasypt或自研一个占位符解密组件。这里给一个轻量方案启动时读取环境变量yml里用占位符引用。spring: datasource: password: ${DB_PASSWORD}启动脚本里export DB_PASSWORDxxx这样源代码仓库里不出现实际密码。数据库里的用户密码字段本身用BCrypt哈希MySQL的mysqldump备份文件泄露时不会直接带出明文口令。心理咨询测评数据属于敏感个人数据需要在表设计时就把数据库账号权限拆分只给应用账号读写的database权限不给FILE和GRANT权限演示结束后及时回收测试账号。5. 答辩前必做的核对清单从预约冲突到压力测试的SpringBoot排错路径5.1 并发预约的验证方法预约冲突代码写完不等于没问题要实际验证。开两个终端同时用curl对一个时段发起预约请求或者用JMeter建一个10并发的线程组打到预约接口观察返回结果中成功数和失败数。预期结果是成功只有1笔其余全部返回“该时段已被预约”。如果出现多笔成功检查两处更新排班的update语句是否真的带status0条件以及事务注解是否生效——常见情况是类内部方法调用导致Transactional失效因为Spring事务走代理this调用会跳过代理。可以这样验证在日志里看更新SQL是否打印再把事务改为在Controller中调public方法。# 快速模拟并发预约观察结果中 success 是否为 1 for i in $(seq 1 10); do curl -s -X POST http://localhost:8080/api/appointment \ -H Content-Type: application/json \ -H Authorization: Bearer $TOKEN \ -d {counselorId:1,startTime:2025-06-10 09:00:00,endTime:2025-06-10 09:50:00} done wait并发结果里除了成功数量还要看失败响应时间是否在可接受范围。如果失败请求响应超过3秒说明连接池或事务处理时间过长优先排查update语句是否走了主键索引counselor_id start_time需要建联合索引。5.2 权限边界过一遍逐角色登录确认学生无法通过直接输入URL访问咨询师接口管理员接口也不能被普通用户调用。拦截器只校验了token有角色但也要校验该角色是否真的允许访问这个路径不能只校验登录状态。检查每个接口的返回数据确认学生信息接口不包含密码哈希字段测评结果只能看到自己的即使修改URL的userId参数也要被拦截。在Service层做一层对象归属校验是最后防线防止越权改数据的情况发生。前端路由跳转会隐藏按钮但不安全后端必须有一套独立的权限校验。这里建议写一个RequireRole注解挂在Controller方法上拦截器里用反射检查注解实现成本很低但答辩时讲解起来非常值钱。具体做法是自定义注解加一个角色数组preHandle里解析当前用户角色并比对。5.3 数据库备份与演示恢复演示当天数据被误删是常见事故要准备好恢复预案。用mysqldump在演示前导出一次完整数据如果现场操作把数据搞乱了直接导入备份即可。给一个最小备份命令mysqldump -uroot -p psy_system psy_backup_$(date %Y%m%d).sql恢复用mysql -uroot -p psy_system psy_backup_20250601.sql。注意mysqldump备份的是库级别的逻辑快照要保证备份时没有并发写入演示数据量小直接锁表备份没影响。备份文件不要放在SpringBoot可访问的静态目录下防止被直接下载。5.4 体检一个隐藏收益点测评报告的PDF导出一旦测评总分和维度分计算正确再补一个PDF导出功能就能成为答辩加分的完整闭环。用Itextpdf或POI生成包含雷达图和分数条的报告把AssessResult的维度得分画成简单图表存为图片再写入PDF。这个功能优先用异步方式生成学生提交测评后返回“生成中”状态通过下载链接轮询结果既避免了同步生成导致的HTTP超时也体现出你对SpringBoot异步任务Async的那一层理解同时把title里的“心理咨询系统”业务完整性补齐了。本文还有配套的精品资源点击获取
SpringBoot大学生心理咨询系统：预约、测评与并发实战
简介一套基于SpringBoot的大学生心理咨询系统完整源码项目面向计算机相关专业毕业设计、实训及全栈开发学习者。项目采用前后端分离架构后端以Java/SpringBoot为核心前端包含大量JavaScript、HTML、CSS及图表组件文件并配套SQL数据库脚本、Maven配置与构建脚本可用于快速搭建心理测评、预约咨询、信息管理等典型功能流程。源码已通过本地编译测试按文档配置环境即可运行适合作为课设模板或二次开发基础。压缩包共3978个文件大小约16.39MB主要以JS、PNG、CSS、HTML、Java等类型构成目录结构清晰。目前已有293人学习下载项目难度适中内容经助教审定能够帮助使用者理解前后端联调掌握SpringBoot与MySQL的整合开发思路同时减少环境踩坑时间是提升全栈实践能力的实用参考。1. 用SpringBoot重构校园心理咨询这个毕设题到底在做什么高校心理咨询中心最头疼的往往不是咨询本身而是“约得上”和“记得住”。预约靠人工排表时咨询师的空档和学生的时间互相看不见放号几分钟就被抢完测评结果散落在纸质问卷里咨询师下次接待时看不到历史分数变化来访记录放在不同老师的电脑里没法汇总分析。基于SpringBoot的大学生心理咨询系统就是把这三条线下流程拆成预约管理、心理测评、咨询记录三个闭环再交给一台服务器统一处理。做这个题的人通常不是技术新手就是时间紧张的应届生所以整套方案要实用、能答辩、能演示。这篇内容会顺着这个标题把需求拆开把表设计出来再给出Login、预约、测评计分三块核心代码最后补上并发冲突和数据泄露两个最容易在答辩现场翻车的点。2. 从需求到表结构SpringBoot心理咨询系统的角色、流程与数据设计2.1 为什么选SpringBoot而不是其它框架这个系统本质上是典型的管理信息系统核心操作就是增删改查、状态流转和角色权限但它比普通的图书管理系统多一个硬约束预约不能冲突。SpringBoot在这个场景下的优势不在“开发快”三个字而在于它把配置、部署、测试三条线都压短了。内嵌Tomcat意味着打包成一个jar就能跑不需要在答辩现场配置外部容器自动装配虽然屏蔽了细节但分层架构依然保留Controller、Service、Mapper各司其职答辩老师问起来你能讲清楚每一层在干什么。生态上MyBatis-Plus处理单表CRUD非常顺手JWT做无状态登录比Session更适合前后端分离Redis缓存测评量表题目能减少数据库压力这些组件全部靠starter引入版本由SpringBoot统一管理不会出现依赖打架的问题。常见做法是SpringBoot 2.7.x MyBatis-Plus 3.5.x MySQL 8.0 JWT这套组合稳定且资料多。如果你用的是JDK 17甚至21建议先试试SpringBoot 2.7系列它能兼容到JDK 17SpringBoot 3.x要求jakarta命名空间很多老教程直接失效除非有明确理由毕业设计阶段没必要给自己加这个难度。2.2 角色权限拆解与业务流程这个题目涉及三类角色权限边界必须从一开始就分清。学生来访者能注册登录、查看咨询师列表、提交预约、填写心理测评量表、查看自己的测评报告和预约记录。咨询师能设置可预约时段、查看分配给自己的预约、填写咨询记录、查看来访者的历史测评摘要。管理员负责审核咨询师账号、管理公告、查看预约统计数据和测评完成率。角色核心操作数据权限范围学生预约、测评、查看报告只能看到自己的预约和测评咨询师排班、接单、填记录只能看到分配给自己的来访者管理员审核、统计、公告全量数据可读但咨询记录建议脱敏显示预约流程是核心链路学生浏览咨询师列表选择一个空闲时间段提交预约系统校验该时间段是否已被占用状态从“待确认”变为“已预约”咨询师可确认或取消。测评流程独立但数据关联学生填写量表系统实时计算总分和分量表得分写入测评结果表同一量表允许多次填写但只在咨询师查看时展示最近一次结果。2.3 核心表的字段设计与建表SQL按上面拆解至少需要六张核心表用户表sys_user、咨询师信息表counselor、预约表appointment、量表表scale、题目表scale_question、测评记录表assessment_result外加咨询记录表counsel_record用于留存咨询师每次接待的文本记录。这里只说三张最容易设计错的表。预约表是重中之重不要只存时间字符串要拆成start_time和end_time两个datetime字段。状态字段用tinyint0待确认、1已确认、2已完成、3已取消。关键设计是给counselor_id、start_time、status建联合唯一索引用数据库兜底同一咨询师同一开始时间只能有一条未取消记录。下面是最小建表语句CREATE TABLE appointment ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL, counselor_id BIGINT NOT NULL, start_time DATETIME NOT NULL, end_time DATETIME NOT NULL, status TINYINT NOT NULL DEFAULT 0, content VARCHAR(500) DEFAULT NULL, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_counselor_start (counselor_id, start_time, status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意这里唯一索引带status是双刃剑。如果预约被取消status变为3新预约插入时status为0索引检查的是不同组合所以取消后的同一时间可以被重新预约。但如果两个请求同时以status0插入同一时间段MySQL会拒绝后插入的那个这就挡住了最直接的并发冲突。外键不建议建逻辑关联足够物理外键在删除用户或咨询师时会造成大量级联操作在线系统一般不用。测评结果表需要记录量表ID、用户ID、总分以及每个分量表的分数。维度分数最好用单独的逗号分隔字符串存一个字段配合另一个字段存维度名称避免为每个维度建列导致表结构僵化。查询时拆开渲染即可答辩演示时比多表关联来得直观。2.4 后端包结构与代码分层约定包结构按com.school.psy为根包下面分controller、service、mapper、entity、dto、config、common七个子包。entity放数据库映射实体dto放前端传入的请求参数和返回给前端的响应对象二者分离是为了不让数据库字段直接暴露给前端比如用户密码哈希绝不能出现在实体返回里。service层做业务校验和事务控制controller层只做参数接收和结果封装这个分层规则要守住答辩时老师大概率会问“为什么预约校验放在service而不是controller”。com.school.psy ├── controller # 接收HTTP请求做参数绑定 ├── service # 业务逻辑事务边界 ├── mapper # MyBatis-Plus的Mapper接口 ├── entity # 数据库实体 ├── dto # 请求/响应对象 ├── config # 拦截器、CORS、MyBatis-Plus配置 └── common # 统一返回、异常处理、常量类实际编码过程中最容易乱的是dto和entity混用。很多项目图省事直接用entity接收前端参数最后在接口文档里暴露了所有字段安全隐患不小。建议每个接口单独定义dto虽然代码量多一点但答辩时“接口隔离”这个点能加分。3. SpringBoot MyBatis-Plus的最小实现登录、预约与测评计分3.1 基于JWT的登录态设计与拦截器配置用户登录用BCrypt存储密码哈希密码校验通过后生成JWT令牌。JWT本身不保存服务端状态适合前后端分离部署但要注意两个细节令牌过期时间不能太长建议2小时注销登录时单纯丢弃令牌不可靠常见做法是加一个Redis黑名单把注销的jti存进去拦截器校验时先查黑名单。这里选JWT而不是Spring Security是因为这个系统的角色只有三种用拦截器加注解足以表达权限规则引入Security框架反而增加配置复杂度。Service public class AuthService { Autowired private SysUserMapper userMapper; Autowired private StringRedisTemplate redisTemplate; public String login(String username, String rawPassword) { SysUser user userMapper.selectOne( new LambdaQueryWrapperSysUser() .eq(SysUser::getUsername, username)); if (user null || !BCrypt.checkpw(rawPassword, user.getPassword())) { throw new BusinessException(用户名或密码错误); } String token Jwts.builder() .setSubject(user.getId().toString()) .claim(role, user.getRole()) .setExpiration(new Date(System.currentTimeMillis() 7200000)) .signWith(SignatureAlgorithm.HS256, jwtSecret) .compact(); return token; } }这段代码里BCrypt.checkpw是恒定时间比较比equals安全。setExpiration明确了两小时过期时间claim里塞了role拦截器可以直接解析角色不用再查一次数据库。注意jwtSecret要放到配置文件里不能硬编码在类中。拦截器要做两层校验先通过JWT解析器验证签名和有效期再检查当前用户角色是否匹配目标接口要求的角色。HandlerInterceptor的preHandle返回false时要写入统一的JSON错误响应而不是直接返回401空页面。3.2 预约接口时间冲突判断与事务控制预约是这个系统里唯一需要严谨考虑并发的业务。一个咨询师的可预约时间段可能只有上午两个、下午三个两个学生同时点同一个时间段如果代码只查数据库“是否有记录”两个请求可能都查到没有记录然后都执行插入导致重复预约。代码层面要做两件事用重叠区间条件更新咨询师排班表记录的状态再插入预约记录整体加事务。Transactional public void createAppointment(AppointmentDTO dto) { LocalDateTime start dto.getStartTime(); LocalDateTime end dto.getEndTime(); if (!start.isBefore(end)) { throw new BusinessException(开始时间必须早于结束时间); } // 关键更新排班记录CAS思想status1表示该时段空闲 int updated counselorScheduleMapper.update(null, new LambdaUpdateWrapperCounselorSchedule() .set(CounselorSchedule::getStatus, 1) .eq(CounselorSchedule::getCounselorId, dto.getCounselorId()) .eq(CounselorSchedule::getStartTime, start) .eq(CounselorSchedule::getEndTime, end) .eq(CounselorSchedule::getStatus, 0)); if (updated 0) { throw new BusinessException(该时段已被预约请选择其他时间); } // 排班更新成功才插入预约记录 Appointment appointment new Appointment(); appointment.setStudentId(dto.getStudentId()); appointment.setCounselorId(dto.getCounselorId()); appointment.setStartTime(start); appointment.setEndTime(end); appointment.setStatus(0); appointmentMapper.insert(appointment); }这段代码有两点值得在答辩时重点解释。update语句带四个条件其中eq(status, 0)是关键——它保证只有原本空闲的记录能被置为占用MySQL的行锁和条件更新让并发请求只有一个能更新成功updated为0的请求直接抛异常。Transactional保证排班表更新和预约表插入要么都成功要么都回滚不会出现排班被占但预约没插上。这个方案比先查询再插入更加可靠因为它把“检查并执行”合并成一个原子操作。时间参数校验也不能省只校验开始时间早于结束时间不够还应检查是否在咨询师设置的开放时段范围内。建议在dto里加Future注解校验开始时间不在过去Spring的Valid会自动触发这个检查。3.3 测评量表计分总分与分量表的动态计算量表题目结构通常是题目表存题干和选项选项值可能是0分到3分部分量表还按维度分组比如抑郁量表分情绪、认知、行为三个维度。计分逻辑要把选项值和题目维度关联起来循环遍历用户提交的答案累加总分和每个维度的分数。用Map保存维度累加值既灵活又不需要预先知道维度数量。public AssessmentResultVO calcScore(Long scaleId, MapLong, Integer answers) { ListScaleQuestion questions scaleQuestionMapper.selectList( new LambdaQueryWrapperScaleQuestion() .eq(ScaleQuestion::getScaleId, scaleId)); int totalScore 0; MapString, Integer dimScore new HashMap(); for (ScaleQuestion q : questions) { Integer answer answers.get(q.getId()); if (answer null) { throw new BusinessException(题目 q.getId() 未作答); } totalScore answer; int dimVal dimScore.getOrDefault(q.getDimension(), 0); dimScore.put(q.getDimension(), dimVal answer); } AssessmentResult result new AssessmentResult(); result.setUserId(currentUserId()); result.setScaleId(scaleId); result.setTotalScore(totalScore); result.setDimensionScores(dimScore.toString()); // 写入测评记录并解析结果等级 return interpretResult(result); }这里Map的key是维度名称value是该维度累加分数toString之后存入数据库的单列字段读取时用JSON反序列化还原。注意答案集合用题目ID作为key是标准做法前端提交时必须回传题目ID否则后端无法定位题目。如果某个量表存在反向计分的题目需要在ScaleQuestion表加一个reverse字段计分时用选项数减一减去当前值。4. 配置与参数调优SpringBoot层面对并发预约和数据安全的处理4.1 application.yml 中的关键配置项与版本选择配置文件按环境拆成application.yml公共、application-dev.yml开发、application-prod.yml演示或部署公共配置放端口、JWT密钥、序列化规则环境配置放数据源和Redis地址。这里给出一个带注释的最小骨架server: port: 8080 tomcat: max-threads: 200 min-spare-threads: 20 accept-count: 100 spring: datasource: url: jdbc:mysql://localhost:3306/psy_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: ${DB_PASSWORD:root} hikari: maximum-pool-size: 10 minimum-idle: 5 redis: host: localhost port: 6379 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: Asia/Shanghai mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 jwt: secret: ${JWT_SECRET:f3a1c2d4e5b6a7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b} expire-hours: 2配置项推荐值作用与坑server.tomcat.accept-count100等待队列长度预约瞬间高并发时不丢请求spring.datasource.hikari.maximum-pool-size10连接池过大反而拖慢10够用mybatis-plus.log-implStdOutImpl开发时打印SQL部署前务必关掉spring.jackson.date-formatyyyy-MM-dd HH:mm:ss不配的话前端拿到的LocalDateTime是数组格式jwt.secret环境变量注入硬编码到yml里会被人扫仓库拿到密钥连接池参数值得多提一句。预约类系统典型场景是短平快的SQL连接池大小不用设置很大10个连接足以支撑几百人同时在线预约反而过大连接数会让MySQL线程切换变严重。如果演示现场出现“请求排队”现象优先看accept-count是否被默认值限制再考虑调大max-threads。4.2 SpringBoot版本过高导致的三个典型坑“springboot版本太高”这个词条经常出现在检索日志里这个项目同样会碰到。如果用SpringBoot 3.0以上有几个坑必须提前知道javax.servlet变成jakarta.servlet所有老代码里的import javax要批量替换spring.factories被废弃自定义starter改用了AutoConfiguration.imports文件MyBatis-Plus要升到3.5.3以上才有对应的spring-boot3-starter。如果教程是2022年之前的几乎全部失效。建议直接固定SpringBoot 2.7.18这是2.x系列的最终维护版本资料最多兼容JDK 8到17做毕设完全够用。还有一类高版本坑是JWT的依赖之前常用的jjwt 0.9.x在JDK 11以上会报模块访问错误换成jjwt 0.11.5后要改用Jwts.builder().signWith(SecretKey)的写法不能再传String密钥。4.3 Actuator端点泄露与HeapDump安全加固在线系统一旦把spring-boot-starter-actuator不加配置地引入就相当于对外暴露了内部运行状态。尤其http://服务器IP:8080/actuator/heapdump能直接把JVM堆内存下载下来堆里有JWT密钥、数据库密码、用户数据这个泄露在实习和正式项目里都是高级漏洞。SpringBoot 2.x默认只开放health端点但很多人为了演示方便把management.endpoints.web.exposure.include设为*这就是把底裤亮给整个公网。修复方案很简单management: endpoints: web: exposure: include: health,info endpoint: health: show-details: never如果确实需要看metrics或heapdump把management.server.port改成和主端口不同的内网端口再通过防火墙限制来源IP。答辩演示前检查一下actuator页面的访问情况非常必要。另一个容易被忽略的点是SpringBoot的error页面会打印堆栈信息如果异常处理不当数据库表名和字段名可能直接出现在响应里。统一异常处理类里要保证返回给前端的信息不包含SQL异常原文。4.4 敏感数据存储配置密文与密码字段处理基本信息配置里的数据库密码和JWT密钥不应该以明文出现在yml里推荐用Jasypt或自研一个占位符解密组件。这里给一个轻量方案启动时读取环境变量yml里用占位符引用。spring: datasource: password: ${DB_PASSWORD}启动脚本里export DB_PASSWORDxxx这样源代码仓库里不出现实际密码。数据库里的用户密码字段本身用BCrypt哈希MySQL的mysqldump备份文件泄露时不会直接带出明文口令。心理咨询测评数据属于敏感个人数据需要在表设计时就把数据库账号权限拆分只给应用账号读写的database权限不给FILE和GRANT权限演示结束后及时回收测试账号。5. 答辩前必做的核对清单从预约冲突到压力测试的SpringBoot排错路径5.1 并发预约的验证方法预约冲突代码写完不等于没问题要实际验证。开两个终端同时用curl对一个时段发起预约请求或者用JMeter建一个10并发的线程组打到预约接口观察返回结果中成功数和失败数。预期结果是成功只有1笔其余全部返回“该时段已被预约”。如果出现多笔成功检查两处更新排班的update语句是否真的带status0条件以及事务注解是否生效——常见情况是类内部方法调用导致Transactional失效因为Spring事务走代理this调用会跳过代理。可以这样验证在日志里看更新SQL是否打印再把事务改为在Controller中调public方法。# 快速模拟并发预约观察结果中 success 是否为 1 for i in $(seq 1 10); do curl -s -X POST http://localhost:8080/api/appointment \ -H Content-Type: application/json \ -H Authorization: Bearer $TOKEN \ -d {counselorId:1,startTime:2025-06-10 09:00:00,endTime:2025-06-10 09:50:00} done wait并发结果里除了成功数量还要看失败响应时间是否在可接受范围。如果失败请求响应超过3秒说明连接池或事务处理时间过长优先排查update语句是否走了主键索引counselor_id start_time需要建联合索引。5.2 权限边界过一遍逐角色登录确认学生无法通过直接输入URL访问咨询师接口管理员接口也不能被普通用户调用。拦截器只校验了token有角色但也要校验该角色是否真的允许访问这个路径不能只校验登录状态。检查每个接口的返回数据确认学生信息接口不包含密码哈希字段测评结果只能看到自己的即使修改URL的userId参数也要被拦截。在Service层做一层对象归属校验是最后防线防止越权改数据的情况发生。前端路由跳转会隐藏按钮但不安全后端必须有一套独立的权限校验。这里建议写一个RequireRole注解挂在Controller方法上拦截器里用反射检查注解实现成本很低但答辩时讲解起来非常值钱。具体做法是自定义注解加一个角色数组preHandle里解析当前用户角色并比对。5.3 数据库备份与演示恢复演示当天数据被误删是常见事故要准备好恢复预案。用mysqldump在演示前导出一次完整数据如果现场操作把数据搞乱了直接导入备份即可。给一个最小备份命令mysqldump -uroot -p psy_system psy_backup_$(date %Y%m%d).sql恢复用mysql -uroot -p psy_system psy_backup_20250601.sql。注意mysqldump备份的是库级别的逻辑快照要保证备份时没有并发写入演示数据量小直接锁表备份没影响。备份文件不要放在SpringBoot可访问的静态目录下防止被直接下载。5.4 体检一个隐藏收益点测评报告的PDF导出一旦测评总分和维度分计算正确再补一个PDF导出功能就能成为答辩加分的完整闭环。用Itextpdf或POI生成包含雷达图和分数条的报告把AssessResult的维度得分画成简单图表存为图片再写入PDF。这个功能优先用异步方式生成学生提交测评后返回“生成中”状态通过下载链接轮询结果既避免了同步生成导致的HTTP超时也体现出你对SpringBoot异步任务Async的那一层理解同时把title里的“心理咨询系统”业务完整性补齐了。本文还有配套的精品资源点击获取