简介面向毕业设计场景的学生心理咨询评估系统源码包基于SpringBoot、Vue和MySQL搭建适合需要完成毕业设计、期末大作业或课程设计的Java方向本专科生。资源提供前后端分离的完整工程结构后端以Java与SpringBoot为核心前端采用Vue组件化页面同时包含MySQL数据库初始化脚本、论文文档与答辩PPT等材料便于从零搭建项目并准备答辩展示。压缩包共四百四十四个文件整体大小约九点九六兆字节主要包含七十三份Java后端源码、七十二份编译后的class文件、三十七份Vue前端组件、二十一份XML配置、十六份JavaScript脚本及图片资源另有SQL脚本、一键安装运行脚本、doc论文文档与PPT答辩材料等目录结构清晰。源码经过本地编译验证可运行评审得分九十八分难度适中内容经助教老师审定适合学习、毕业设计或课程设计使用。目前已有九十七人浏览/学习能够支撑从环境搭建、功能演示到论文撰写的完整流程帮助读者快速理解前后端分离项目的实际落地过程。1. 学生心理咨询评估系统SpringBootVueMySQL 从题目到可答辩的三道坎一个基于 SpringBootVueMySQL 的学生心理咨询评估系统表面看只是「问卷 后台管理」的 CRUD真正拉开差距的是量表建模、计分规则和结果解读这三块。许多同学把答辩讲成了「我做了增删改查」分数上不去不是代码量不够是设计意图没有讲透。这个题目天然覆盖 SpringBoot 分层接口、Vue 路由与状态管理、MySQL 表设计与索引还能顺势展示角色权限、数据可视化和报表导出几乎把毕业设计要考察的点串齐了。对准备找后端开发岗位的同学来说答辩时的计分逻辑和权限设计可以直接当面试案例讲。下文按需求拆解、数据模型、后端实现、前端联调、答辩资料五条线推进关键代码给到可直接改写的程度参数与坑单独标注。2. 先把数据模型定好评估量表的模块拆分与 MySQL 建表心理咨询评估系统和普通问卷系统的差别在于量表本身是结构化的。以最常用的症状自评量表 SCL-90 为例90 道题10 个维度每道题只归属一个维度选项统一为 1 到 5 分。如果按「题目表 答案表」的朴素设计直接做算维度分时要么在业务代码里写长串 if-else要么在 SQL 里反复 group by之后每加一个量表就要改一次代码。因此第一步不是写接口而是把「量表、维度、题目、评估记录、作答明细、报告」六类对象拆开建表。2.1 角色与用例先定清管理员、学生、咨询师系统按三个角色切用例。管理员负责学生账号导入、量表启停、查看全部评估概况学生登录后做测评、查看自己的报告咨询师只能看到被授权学生的结果并在报告上补充咨询记录。这个划分直接决定后端权限的最小粒度接口至少要区分「已登录用户」「学生本人数据」「咨询师被授权数据」「管理员数据」四层而不是简单分三个角色就完事。功能范围不建议铺太大。把「发起测评、作答、提交、自动计分、生成报告、查看报告、风险提示」七条主线跑通工作量已经足够覆盖毕设要求预约排班、留言板这类功能属于加分项有余力再补否则会挤占计分逻辑和报表视图的打磨时间。答辩时导师更愿意看到一条主线做深而不是五个模块每个都浅。2.2 评估量表怎么落库用四张表解决维度计分量表的建模核心是「维度」不是题目。把维度单独建表后新增量表或调整维度归属都只需要改数据后端判分逻辑不用动。下面这套表结构可以直接执行建库字段统一用下划线命名后端打开驼峰映射即可自动对应实体属性。-- 维度表一个量表包含多个维度 CREATE TABLE psy_dimension ( id BIGINT PRIMARY KEY AUTO_INCREMENT, scale_code VARCHAR(32) NOT NULL COMMENT 量表编码如 SCL90, dim_code VARCHAR(16) NOT NULL COMMENT 维度编码如 SOM, dim_name VARCHAR(32) NOT NULL COMMENT 维度名称如躯体化, sort_no INT NOT NULL DEFAULT 0 COMMENT 维度展示顺序, UNIQUE KEY uk_scale_dim (scale_code, dim_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT评估维度表; -- 题目表每道题归属一个维度 CREATE TABLE psy_item ( id BIGINT PRIMARY KEY AUTO_INCREMENT, scale_code VARCHAR(32) NOT NULL COMMENT 量表编码, item_no INT NOT NULL COMMENT 题号从 1 开始, content VARCHAR(512) NOT NULL COMMENT 题目内容, dim_code VARCHAR(16) NOT NULL COMMENT 所属维度编码, reverse_score TINYINT NOT NULL DEFAULT 0 COMMENT 1反向计分, UNIQUE KEY uk_scale_item (scale_code, item_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT量表题目表; -- 评估记录表一次完整测评 CREATE TABLE psy_record ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL COMMENT 学生用户 id, scale_code VARCHAR(32) NOT NULL COMMENT 量表编码, status TINYINT NOT NULL DEFAULT 0 COMMENT 0未提交 1已提交 2已出报告, total_score DECIMAL(8,2) DEFAULT NULL COMMENT 总分提交后写入, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, submit_time DATETIME DEFAULT NULL COMMENT 提交时间, KEY idx_student_time (student_id, create_time) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT评估记录表; -- 作答明细表一次记录对应多道题 CREATE TABLE psy_answer ( id BIGINT PRIMARY KEY AUTO_INCREMENT, record_id BIGINT NOT NULL COMMENT 评估记录 id, item_id BIGINT NOT NULL COMMENT 题目 id, option_value INT NOT NULL COMMENT 选项分值 1-5, KEY idx_record (record_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT作答明细表;这段 DDL 有几个点容易忽略答辩时讲清楚很加分。第一scale_code 用业务编码而不是自增主键日志和接口参数里直接看出是 SCL90 还是焦虑自评量表 SAS排查问题不用回查表第二reverse_score 必须预留SAS、SDS 这类量表存在反向计分题建模时漏掉它计分服务就只能为单个量表写特殊分支第三option_value 只存分值不存选项文本文本属于前端展示层「没有、很轻、中等、偏重、严重」这组文案是固定的存数字即可。表拆分后新增量表的成本就是录入 psy_dimension 和 psy_item 两张表的数据计分、报告、雷达图全部复用。这也是论文里值得用一小节去描述的设计决策。2.3 评估记录的状态机与索引策略psy_record 的 status 字段是整个流程的状态锚点建议只保留三态不要加「已取消」「已过期」这类状态否则前端每个按钮都要判断多态。状态值状态名触发动作前端展示0未提交提交时写入答案并更新状态继续作答 / 恢复草稿1已提交计分服务生成报告后更新报告生成中2已出报告查看报告接口可返回数据展示雷达图与结果提交接口必须在一个事务里完成「写 answer 明细 更新 record 状态 写 report 报告」三步否则出现半截数据重算报告时会漏题或对不上时间。索引方面psy_record 按 (student_id, create_time) 建联合索引支撑「某学生最近三次测评的趋势曲线」psy_answer 只需要 (record_id) 单列索引计分时通过 item_id 关联题目表取值不要把题目内容冗余进明细表。查询报告列表也不要先把 answer 全量 join 出来先查 record再按需加载明细数据量上来后这个差别很明显。3. SpringBoot 后端实现计分规则、JWT 权限与提交防重后端我用经典三层结构Controller 只做参数接收和结果包装Service 承担计分、状态流转与权限校验Mapper 用 MyBatis-Plus 的 BaseMapper 减少样板代码。答辩时被问「为什么不用 JPA」回答口径是本系统查询大多围绕 record_id 和 student_id 做简单关联MyBatis-Plus 的 lambda 查询可读性好SQL 可预期需要调优时能直接拿到语句分析执行计划。3.1 工程创建与 application.yml 必调配置创建项目时Spring Boot 版本别追太高JDK 8 就用 2.7.xJDK 17 及以上再选 3.x。版本与 JDK 不匹配会在启动阶段直接报错这也是「springboot 版本太高」引起的一类高频启动问题锁定版本后建议顺手把 Maven 仓库镜像配好依赖拉取会快很多。依赖方面选 web、validation、mysql-connector-j、mybatis-plus-boot-starter、jjwt 就够不需要额外引入重量级组件。spring: datasource: url: jdbc:mysql://localhost:3306/psy_assess?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 mybatis-plus: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true连接串里的 serverTimezone 必须显式指定新版 MySQL 驱动对时区敏感缺了它会在建立连接时抛异常characterEncoding 要和 useUnicode 成对出现否则中文题目容易乱码。jackson 的 time-zone 不配报告页的时间会差 8 小时答辩现场改代码是很尴尬的。map-underscore-to-camel-case 打开后表字段 create_time 自动映射到实体属性 createTime建表时坚持下划线命名每张表都省掉一份 ResultMap。3.2 计分服务维度均分、总分与风险判定计分是答辩最容易被追问的模块代码要能讲清「为什么这么算」。以五点评分量表为例每个选项对应 1 到 5 分反向题按「6 减原分」处理。下面这个方法接收 recordId一次查出全部作答再按维度聚合。有的实现会把计分写成 MySQL 存储过程我建议放应用层逻辑可单测、可读性好改判定规则不用动数据库对象部署也更简单。Service public class AssessScoreService { public ReportVO computeScore(Long recordId) { ListAnswerItem answers answerMapper.selectByRecordId(recordId); MapString, Double dimSum new HashMap(); MapString, Integer dimCount new HashMap(); for (AnswerItem a : answers) { ItemDO item itemMapper.selectById(a.getItemId()); double score a.getOptionValue(); if (item.getReverseScore() 1) { score 6 - score; // 五点评分反向题统一处理 } dimSum.merge(item.getDimCode(), score, Double::sum); dimCount.merge(item.getDimCode(), 1, Integer::sum); } ListDimScore dimScores dimSum.entrySet().stream() .map(e - new DimScore( e.getKey(), BigDecimal.valueOf(e.getValue() / dimCount.get(e.getKey())) .setScale(2, RoundingMode.HALF_UP))) .collect(Collectors.toList()); double total dimScores.stream().mapToDouble(DimScore::getAvg).sum(); BigDecimal totalScore BigDecimal.valueOf(total).setScale(2, RoundingMode.HALF_UP); return buildReport(recordId, dimScores, totalScore); } }dimSum 和 dimCount 两个 Map 分别累计每个维度的总分与题数最后相除得到维度均分。用 Map.merge 而不是先 containsKey 再计算少写三行分支且语义直观。dim_code 从题目表读取而不是写死在代码里SCL-90、SAS 共用同一套计分方法新增量表只需补维度与题目数据。均分统一用 BigDecimal 的 HALF_UP 保留两位小数避免浮点累加误差在报告页暴露出 38.999999 这种数字。风险判定建议做成配置项而不是硬编码。可以在 system_config 表维护「总分预警阈值」「维度均分预警阈值」两个参数判分时读取答辩时现场改阈值看报告级别变化是很自然的演示脚本。参考口径总分超过 200 或任一维度均分超过 3 判为「建议关注」维度均分超过 3 的项在报告中标记颜色。报告里固定保留一句「本评估结果仅作筛查参考不构成诊断结论」这句话在论文和系统里都要出现。3.3 JWT 登录与三层权限拦截权限这块我做的方案是 JWT Spring MVC 拦截器不引入 Spring Security理由是对毕业设计的接口规模来说Security 的配置成本高于收益。登录接口校验账号密码后签发 token后续请求在拦截器里解析并写入 request 属性。Component public class JwtInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String header request.getHeader(Authorization); if (header ! null header.startsWith(Bearer )) { Claims claims JwtUtil.parse(header.substring(7)); request.setAttribute(userId, claims.get(uid)); request.setAttribute(role, claims.get(role)); return true; } response.setStatus(HttpStatus.UNAUTHORIZED.value()); return false; } }注册拦截器时按路径分三组/api/auth/** 完全放行/api/student/** 与 /api/counselor/** 要求登录/api/admin/** 在登录基础上再校验 role 为 ADMIN。JWT 有效期学生端建议 2 小时管理员端 8 小时过期统一返回 401前端拦截到后清 token 跳登录页。加密直接用 jjwt 的 HS256密钥放到 application.yml答辩时能说清「密钥与有效期都是配置项」就足够。不要在代码里自定义加密算法那是明显的扣分点。3.4 三个必调参数与提交防重参数位置场景推荐值spring.datasource.hikari.maximum-pool-sizeapplication.yml本地答辩演示连接数不必拉高10spring.jackson.time-zoneapplication.yml报告时间差 8 小时GMT8mybatis-plus.configuration.log-implapplication.yml答辩排错时看真实 SQLStdOutImpl重复提交的防重我一般做两层Service 层先查 psy_record 的 status只有 0 才能提交更新时再把状态改成 1配合乐观锁版本号二次请求进来时版本已变更新影响行数为 0 直接抛错前端在提交回调里立即把按钮置为 loading并跳转报告页。两层都做既防手滑双击也防接口被脚本重放。4. Vue 前端联调路由权限、作答页与评估报告展示前端用 Vue 3 Vite Element Plus 是当前的主流组合目录按「登录、学生端、咨询师端、管理端」划分。这一章重点讲三个答辩高频点路由守卫怎么控权限、作答数据怎么防丢失、报告图表数据从哪来。别把精力花在花哨的动画上数据链路清晰才是加分项。4.1 路由设计与 vue-router 的 meta 角色控制路由表集中在 router/index.js 中按模块拆 children每个页面配置 meta.role 声明可访问角色。路由参数 recordId 用 props: true 传给页面组件组件里直接声明 props 接收模板中不用写一长串 $route.params 取参这是 vue-router 参数传递的标准写法。const routes [ { path: /login, component: () import(/views/Login.vue) }, { path: /assess/start, component: () import(/views/student/AssessStart.vue), meta: { role: [STUDENT], title: 开始测评 } }, { path: /report/:recordId, component: () import(/views/student/ReportDetail.vue), meta: { role: [STUDENT, COUNSELOR], title: 评估报告 }, props: true } ] router.beforeEach((to, from, next) { const token localStorage.getItem(token) const role localStorage.getItem(role) if (to.meta.role !token) { next(/login) } else if (to.meta.role !to.meta.role.includes(role)) { next(/403) } else { next() } })路由全部用 () import 懒加载打包后按页面拆 chunk首屏不用拉完整包。全局前置守卫做两件事没有 token 跳登录角色不匹配跳 403。判断逻辑写在路由层而不是散落在每个页面里新增页面只要配好 meta 就自动有权限保护。后端接口层面再做一层校验两层夹住答辩时讲「前端控制体验、后端控制安全」这句话是加分项。4.2 axios 封装与 token 注入请求统一走封装好的 http 实例baseURL 用相对路径 /api。本地开发在 vite.config.js 里配置 server 转发规则把 /api 开头的请求转发到 8080 端口打包后由 Nginx 按路径转发到后端服务。前后端地址不在代码里写死换环境只改部署配置不改源码。import axios from axios const http axios.create({ baseURL: /api, timeout: 10000 }) http.interceptors.request.use(config { const token localStorage.getItem(token) if (token) { config.headers.Authorization Bearer ${token} } return config }) http.interceptors.response.use( res res.data, err { if (err.response err.response.status 401) { localStorage.removeItem(token) localStorage.removeItem(role) window.location.href /login } return Promise.reject(err) } )响应拦截器直接返回 res.data业务代码里不用每处写 .data.data层级少一层。401 统一清空本地登录态并跳登录页token 过期、被篡改、权限不足走同一条路径前端不需要在每个接口里重复处理错误。常见坑是打包后部署在子路径时样式丢失、布局错乱把 Vite 的 base 配成 ./路由改用 createWebHashHistory子路径部署下刷新页面也不会 404答辩当天少折腾。4.3 作答页整卷滚动、自动草稿与提交校验评估作答页用整卷滚动而不是一题一页减少翻页次数90 道题一次作答完体验和纸质量表一致。题目从后端按量表编码拉取选项用 Element Plus 的单选组答案对象以题目 id 为 key 收集。template div classassess-page div v-foritem in items :keyitem.id classquestion-card p{{ item.itemNo }}. {{ item.content }}/p el-radio-group v-modelanswers[item.id] el-radio :label1没有/el-radio el-radio :label2很轻/el-radio el-radio :label3中等/el-radio el-radio :label4偏重/el-radio el-radio :label5严重/el-radio /el-radio-group /div el-button :disabledunansweredCount 0 :loadingsubmitting clicksubmitAssess 提交测评 /el-button /div /template未作答数由计算属性统计只要还有漏题提交按钮就是禁用态后端极少收到「第 18 题未答」这种不完整请求。草稿按 recordId 存进 localStorage每题选择时自动写入刷新页面后恢复这个细节在答辩演示中很实用——演示时切后台不小心刷新回来数据还在。提交成功后立刻清草稿、跳转报告页按钮进入 loading 状态防止二次提交。4.4 报告页雷达图与导出方案的取舍报告页数据来自 /api/record/{id}/report 接口返回维度均分数组和总体结论。维度数量在十个左右时雷达图是展示形状最合适的图表一眼能看出哪个维度偏高超过 12 个维度时雷达图标签会拥挤换成横向柱状图更清楚。雷达图用 ECharts 的 radar 类型indicator 由维度表动态生成不要把维度名写在页面里。const option { radar: { indicator: dims.map(d ({ name: d.dimName, max: 5 })) }, series: [{ type: radar, data: [{ value: dimScores.map(d d.avg), name: 本次评估 }] }] }indicator 的 max 设为 5与五点评分上限一致维度均分制统一为 1 到 5便于跨量表对比。导出功能常见两种做法按场景取舍方案适用场景依赖说明浏览器打印另存 PDF报告预览页无用 media print 控制打印样式零依赖后端 POI 导出 Excel管理端批量汇总apache poi适合导出全量评估统计二次计算更方便答辩时被问「为什么不用后端直接出 PDF」回答口径报告是动态网页打印样式用 CSS 控制后另存 PDF 完全够用省掉服务端渲染模板的复杂度管理端要做跨学生的汇总统计时才值得引入 POI 走 Excel。按场景拆工具比一律用同一套导出逻辑更合理。5. 答辩资料与源码整理演示数据、高频问题与验证清单5.1 演示数据先造好答辩前一晚最不该做的事是现场注册账号、现场做题。正确做法是写一个 data.sql 或独立 SQL 脚本固定生成三个学生、两个咨询师、若干测评记录覆盖「低风险、建议关注、高风险」三种结果。演示时直接登录固定账号打开现成报告讲雷达图和风险判定比现场刷题快了不止十分钟。造数脚本要能反复执行推荐先用 DROP TABLE IF EXISTS 清理再插入固定 id 的数据保证每次运行结果一致。5.2 高频答辩问题与源码位置对照答辩提问大多围绕「为什么这么设计」和「某个功能在哪实现」。下面这组问题和源码位置的对应关系建议提前过一遍追问方向回答要点对应代码位置量表维度如何设计维度独立建表新增量表只加数据psy_dimension、psy_item 表反向计分如何实现6 减原分score 字段记录开关AssessScoreService 中 reverse 分支token 过期怎么处理401 统一拦截前端清登录态跳转JwtInterceptor axios 响应拦截器如何防止重复提交服务层 status 校验 乐观锁前端 loadingAssessSubmitService、submitAssess 接口报告结论如何判定配置阈值而非硬编码system_config 表与判定方法每个问题都要能现场打开对应文件指出位置这比背答案有说服力。springboot 面试里常问的 IOC 注入、事务失效场景也可以借这套代码举例提交接口的 Transactional 只放在 public 方法上同类内部调用会绕过代理这是事务不生效的典型场景。5.3 打包验证与交付收尾交付前把后端打包、前端构建、环境依赖整理成一条命令收尾时重复执行三次确认mvn clean package -DskipTests npm install npm run build打包完成后按清单核对后端 jar 能在干净环境下启动连接的是本地 MySQL 数据库前端 dist 目录通过 Nginx 转发后页面样式正常动态刷新不 404data.sql 在空库执行一次后三个演示账号都能登录。论文里的表结构截图要与 database 目录下的 schema 脚本一致别出现论文画了六张表、脚本里只有五张的疏漏。最后在 resources 目录放一个 banner.txt 自定义启动画面把系统名和版本写进去启动日志第一屏就是项目标识演示开机时比默认的 Spring 图标更完整答辩画面和源码交付在这个细节上对齐。本文还有配套的精品资源点击获取