简介这是一份面向高校毕业设计的Java微信小程序心理测评项目方案包含完整可运行代码与配套论文适合需要借鉴前后端分离开发、小程序交互实现或大学生心理健康管理场景的开发者。系统围绕咨询师管理、用户管理、心理健康管理、心理咨询师预约、心理测评、题目库维护、通知公告、论坛交流、字典值设置及轮播图管理等功能模块展开覆盖了从测评发布到预约跟踪的完整业务链可作为课程设计或毕业设计的实施方案。资源共1508个文件其中Vue组件与JS逻辑支撑前端页面交互Java类提供后端接口wxml/wxss构建小程序界面JSON与XML用于配置SQL脚本完成数据库初始化另有常见图片、文档说明等压缩包整体约41.99MB目录结构清晰。当前已有79人学习浏览适合参考其模块划分、接口设计和论文结构能有效降低从零搭建系统的成本为二次开发或论文撰写提供直接素材。1. 为什么毕业设计选它基于微信小程序的大学生心理健康测评管理系统一套代码打通学生端与管理端如果你下载过这个基于微信小程序的大学生心理健康测评管理系统第一眼看到压缩包里那一堆.css.bak、.vue.bak后缀的文件时大概率有点懵——这明显是 uni-app 构建后的产物不是能在 IDE 里直接改着玩的源码形态。我拆完这套 Java 毕业设计项目之后反而觉得它是少见的完整样本学生端测评、咨询师预约、管理员后台三种角色全都能在一个系统里形成业务闭环。做毕设选这个题目比只写一个增删改查的 Web 系统扎实不少。它内置十个管理功能数据库表、接口、论文、可运行代码全配齐适合正在找 Java 课程设计案例源码、又不想从零搭脚手架的人。2. 系统架构与技术选型Spring Boot uni-app MySQL毕业设计最稳的三角组合2.1 十个功能模块先按角色归边再看技术栈为什么这样选这套系统的功能清单乍一看很长十个模块咨询师管理、用户管理、心理健康管理、咨询师预约管理、心理测评管理、题目管理、通知公告管理、论坛管理、字典值管理、轮播图管理。拆的时候我习惯先按角色归边而不是按功能列表一个一个看归完你会发现它本质上是一个标准的多角色权限系统只是业务主题换成了心理健康测评。角色负责的功能模块核心操作管理员Web 端咨询师管理、用户管理、题目管理、通知公告、论坛审核、字典值、轮播图增删改查、审核、发布咨询师Web/小程序心理健康管理、预约处理、测评结果查看录入建议、确认预约、查看测评学生微信小程序心理测评、测评记录、预约咨询师、查看公告、论坛发帖做测评、提交预约、查看结果角色归完就能看出技术栈选择的原因。后台管理层用 Spring Boot 提供 RESTful API学生端用 uni-app 开发并编译到微信小程序两个端共用同一套 MySQL 数据库互补得很干净。这类组合在 Java 毕业设计里几乎是最稳的Spring Boot 负责业务逻辑和权限控制uni-app 负责跨端复用MySQL 存储结构化测评数据各层边界清楚答辩时画架构图也非常好画。2.2 后端接口怎么设计以心理测评提交为例子讲清 RESTful 规范后端接口设计是整个系统能不能答辩过关的关键评分老师最常盯的就是接口风格。这套系统的接口遵循的是标准 RESTful 风格资源用名词复数动作交给 HTTP Method。比如测评相关的核心路径是这样组织的// 测评相关接口 - 缩略示意 RestController RequestMapping(/api/assessment) public class AssessmentController { Autowired private AssessmentService assessmentService; // 获取学生可参与的测评列表 GetMapping(/list) public Result getAssessmentList(RequestParam Long studentId) { return Result.success(assessmentService.getAvailableList(studentId)); } // 提交测评答案接口入参是题目ID列表内部批量落库 PostMapping(/submit) public Result submitAssessment(RequestBody AssessmentSubmitDTO dto) { // 前置校验测评ID是否存在、学生是否已提交过 if (!assessmentService.checkAssessmentExists(dto.getAssessmentId())) { return Result.error(测评不存在); } if (assessmentService.hasSubmitted(dto.getStudentId(), dto.getAssessmentId())) { return Result.error(该测评已提交不能重复作答); } assessmentService.saveAnswerBatch(dto); return Result.success(提交成功); } }这里有个值得注意的设计submit接口里做了「是否已提交过」的幂等校验。很多毕业设计不做这一步学生连续点击两次提交按钮就会生成两条重复记录答辩演示时特别容易翻车。AssessmentSubmitDTO是专门为提交动作建的数据传输对象里面一般会包含studentId、assessmentId、ListAnswerItem三段数据。这种 DTO 隔离的做法我建议保留——它让 Controller 层不需要感知前端到底传了哪些字段也方便做字段校验的注解。前端提交时统一走 POST返回值统一用Result包装里面带code、msg、data三个字段小程序端拿到后只需要判断code是否为 200。2.3 小程序端的页面结构与请求封装前端这一侧压缩包里保留了大量 uni-app 页面源码文件像uni-fab.vue.bak这种就是用到了。uni-app 的页面结构是按分包思路组织的登录页、首页、测评页、预约页、个人中心页各自独立成.vue文件路由由pages.json控制。工程里保留了编译后的 dist 产物但也留了源码目录直接用 HBuilderX 或微信开发者工具都能打开。小程序端最关键的工程点不是页面长什么样而是请求封装。整套系统所有接口调用几乎都收敛在一个request.js文件里// common/request.js - 网络请求统一封装 const BASE_URL http://127.0.0.1:8080/api; function request(url, method GET, data {}) { return new Promise((resolve, reject) { uni.request({ url: BASE_URL url, method: method, data: data, header: { Content-Type: application/json, token: uni.getStorageSync(token) || }, success: (res) { if (res.data.code 200) { resolve(res.data.data); } else if (res.data.code 401) { // token过期清理本地缓存并跳转登录页 uni.removeStorageSync(token); uni.reLaunch({ url: /pages/login/login }); reject(登录状态已过期); } else { uni.showToast({ title: res.data.msg, icon: none }); reject(res.data.msg); } }, fail: (err) { uni.showToast({ title: 网络异常请检查后端服务, icon: none }); reject(err); } }); }); } // 对外暴露常用方法 export const get (url, params) request(url, GET, params); export const post (url, data) request(url, POST, data);这个封装包含一个容易被忽略的细节token从本地存储里读取每次请求自动带上收到 401 状态码时做自动登出处理。这批代码如果拿到手后想改后端鉴权方式只需要动这个文件的header部分不用逐页修改。参数说明url不写全路径只写相对路径统一拼接BASE_URL这样后端如果改了端口只改一处就能全局生效。3. 把后端跑起来环境、数据库、配置文件一次到位3.1 环境版本匹配JDK 与 MySQL 8.x 的配合后端跑不起来八成不是代码问题是环境版本匹配问题。我先说版本搭配再讲启动。这套系统后端是标准 Spring Boot 工程压缩包里包含1-install.bat、2-run.bat、3-build.bat三个批处理脚本。从脚本命名能看出作者原本是打算做成「一键安装、一键启动、一键打包」的但实际运行时环境差异会让脚本失效所以环境得先做核对。组件推荐版本说明JDK1.8 或 11Spring Boot 2.x 对应 JDK83.x 对应 JDK17先看 pom.xmlMaven3.6用于依赖下载和打包MySQL5.7 或 8.0注意驱动名差异8.x 用com.mysql.cj.jdbc.DriverHBuilderX最新稳定版用于重新编译小程序端源码微信开发者工具最新稳定版用于预览和调试小程序如果你打开pom.xml看到spring-boot-starter-parent的版本号是 2.xJDK 千万别装 17最好直接用 1.8。这是我拆项目时固定的第一步先看pom.xml里的 Spring Boot 版本再决定本地 JDK顺序反了会踩编译错误。3.2 数据库初始化SQL 导入顺序与字段校对数据库初始化是整个部署里最容易出错的一步。这套系统的 SQL 脚本一般是psy_assessment.sql或者按模块拆分的多个脚本文件导入时要注意顺序——先建库再建表先建主表再建关联表。很多毕业设计的 SQL 文件里外键依赖是隐式的如果一次性导入报错就得分段执行。我一般用命令行导入比图形化工具更直观# 1. 创建数据库字符集一定要用utf8mb4 mysql -u root -p -e CREATE DATABASE IF NOT EXISTS psy_assessment DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 2. 导入全部SQL脚本按文件名顺序逐个执行 mysql -u root -p psy_assessment database/psy_assessment.sql # 3. 验证核心表是否存在 mysql -u root -p -e USE psy_assessment; SHOW TABLES;导入成功后重点校对三张核心表student学生表、assessment测评表、assessment_question题目表。我见过多次测评模块运行报错原因都是题目表里的type字段明明设置的是选择题类型但选项字段option_a、option_b为空前端渲染选择题时直接白屏。如果 SQL 脚本里INSERT语句很稀疏先用SELECT COUNT(*)确认题目数据量是否正常。字符集utf8mb4这个点特别强调如果建库时用了默认的utf8学生表里存储的中文用户名没问题但论坛模块一旦有人发帖带了 Emoji 字符数据库会直接报Incorrect string value错误这个坑在后端日志里表现得很隐蔽。MySQL 8.x 默认字符集就是utf8mb4但 5.7 需要手动指定务必按上面的命令建库。3.3 启动后端从 application.yml 到第一条接口验证数据库就绪后就轮到后端启动。打开src/main/resources/application.yml需要核对三个关键配置数据库地址、端口号、文件上传路径。默认配置一般是localhost:3306但我遇到过好几次用户本地 MySQL 端口改成了 3307导致后端启动失败所以这步不能跳过。server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/psy_assessment?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: your_password_here driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 50MB max-request-size: 50MB如果你的 MySQL 是 5.7driver-class-name需要改成com.mysql.jdbc.Driver同时 URL 里的serverTimezone参数可以去掉这是两个版本非常明显的差异点。max-file-size和max-request-size建议保留因为轮播图管理模块需要上传图片默认 1MB 上限会在上传大图时静默失败后端日志里只会出现一条让人摸不着头脑的 500 错。启动时直接用批处理脚本2-run.bat或者手动执行mvn spring-boot:run启动日志里看到Started Application in x.xxx seconds后打开浏览器访问http://127.0.0.1:8080/api/assessment/list?studentId1如果能返回 JSON 数据说明后端已经通了。这一步验证非常重要后端没起来之前不要去碰小程序否则前端会一直报网络异常让你误以为是代码问题。4. 小程序端联调从 uni-app 源码到微信开发者工具真机预览4.1 uni-app 项目的导入与依赖管理小程序端的源码目录里包含pages、static、common、components等标准目录结构以及manifest.json、pages.json两个核心配置文件。拿到源码后我习惯用 HBuilderX 导入而不是直接用微信开发者工具打开因为 HBuilderX 能直接识别 uni-app 工程结构并且可以重新发行到微信小程序。导入步骤很简单打开 HBuilderX选择「文件 → 导入 → 从本地目录导入」选到源码所在目录。导入后先确认manifest.json里的微信小程序配置一栏AppID需要填入你自己的小程序测试号或者留空使用测试号也行。{ mp-weixin: { appid: 你的小程序AppID或测试号, setting: { urlCheck: false, es6: true, minified: true }, usingComponents: true } }urlCheck: false对应微信开发者工具里的「不校验合法域名」选项这个设置只影响开发环境发行上线时微信官方要求后端接口必须配置 HTTPS 并加入白名单。大部分毕业设计演示走的是本地真机调试所以这里保持false就好。导入后如果页面里引用了第三方组件库通常需要在项目根目录执行一次npm install但大多数 uni-app 项目的依赖已经内置在components或uni_modules目录里这套系统没有特殊的外部依赖所以直接编译就能过。编译方式是HBuilderX 菜单栏「运行 → 运行到小程序模拟器 → 微信开发者工具」。第一次运行时 HBuilderX 会自动调用微信开发者工具打开项目如果没有自动弹出检查微信开发者工具是否开启了「服务端口」设置。4.2 接口地址配置与本地联调的几个选择联调时最闹心的是接口地址。后端跑在电脑本地微信开发者工具模拟器里访问localhost是有问题的——模拟器里localhost指向的不是你电脑而是它自己。这套系统的common/request.js文件里默认写的http://127.0.0.1:8080/api在模拟器里通常能通但如果你用真机预览手机里的127.0.0.1指向手机自己那就必然失败。真机联调的正确做法是让手机和电脑连同一个 Wi-Fi把BASE_URL里的地址改成电脑的局域网 IP# 查看电脑局域网IPWindows ipconfig # macOS / Linux ifconfig// 修改后的请求地址示例 const BASE_URL http://192.168.1.100:8080/api;注意这里还有一层坑后端 Spring Boot 默认绑定的是127.0.0.1如果前端改了BASE_URL为局域网 IP后端也要改启动配置在application.yml里加上server.address: 0.0.0.0否则手机请求到电脑后后端会因为绑定了本机回环地址而直接拒绝连接。这种情况下的报错典型特征是小程序端显示「网络异常」但后端日志里完全没有收到任何请求记录。4.3 三种角色的登录与测评全流程走查接口地址通掉之后不要急着测全部功能先把「学生登录 → 首页做题 → 提交测评 → 查看报告 → 预约咨询师」这五步主线走一遍这一步比单个功能测试更能发现问题。先说登录登录页提交表单后request.js封装的post方法会拿到后端返回的token并缓存在本地之后所有请求自动携带这个token。测评页的数据流值得单独说// pages/assessment/assessment.vue - 测评页核心逻辑 onLoad(options) { // options.assessmentId 是由测评列表页跳转时传过来的 this.assessmentId options.assessmentId; this.loadQuestions(options.assessmentId); }, methods: { async loadQuestions(assessmentId) { const res await get(/assessment/question/list?assessmentId${assessmentId}); this.questionList res; }, async submit() { // 答题进度校验未完成的题目明确提示 const unanswered this.questionList.filter(q !this.answerMap[q.id]); if (unanswered.length 0) { uni.showToast({ title: 还有${unanswered.length}题未作答, icon: none }); return; } const answerList this.questionList.map(q ({ questionId: q.id, optionId: this.answerMap[q.id] })); const res await post(/assessment/submit, { assessmentId: this.assessmentId, answerList: answerList }); if (res 提交成功) { uni.redirectTo({ url: /pages/result/result?assessmentId${this.assessmentId} }); } } }这段代码里有两个细节都是答辩时可能被追问的点。第一loadQuestions接口返回的是题目列表包括题目内容、选项文本、题目类型第二submit方法里对所有未答题做了前端拦截未完成任务不允许提交。设计这套拦截逻辑的目的是避免用户提交空表单直接走后端校验前端尽早拦截能减少无效网络请求。最终提交的数据结构是assessmentId answerList每个答案项只包含questionId和optionId扫描题和量表题的区别在后端实时计算时处理前端不需要关心。如果在真机上走完这五步每一步能正常跳转、数据不丢这套系统的小程序端就算彻底通了。剩下的模块像论坛、公告、轮播图都是相同套路接口通一个后面全是复制粘贴。5. 避坑指南这套系统最常见的六次翻车现场5.1 现象小程序模拟器里页面一直转圈控制台报request:fail原因我在上文提到过微信开发者工具模拟器里localhost指向的不是开发电脑而是模拟器沙箱环境。这套系统的common/request.js里默认写了127.0.0.1:8080一般情况下模拟器能通但如果后端启动时绑定了127.0.0.1那模拟器发送的请求到不了开发者电脑。解决后端application.yml显式加server.address: 0.0.0.0前端request.js保持127.0.0.1或者改成本机局域网 IP然后重启两端。这个配置改完后模拟器和真机都能访问。5.2 现象启动 Spring Boot 时报ClassNotFoundException: com.mysql.jdbc.Driver原因SQL 是 MySQL 8.x 生成的数据源配置里驱动类写的是com.mysql.jdbc.Driver但你的 MySQL 驱动 JAR 版本是 8.x。MySQL 8 的驱动类已经改名成com.mysql.cj.jdbc.Driver旧类名虽然兼容但属于遗留状态日志里会给出提示。解决把application.yml里的driver-class-name改成com.mysql.cj.jdbc.Driver同时检查pom.xml里mysql-connector-java的版本号8.x 对应的依赖坐标是mysql:mysql-connector-java:8.0.33。5.3 现象测评提交后接口返回成功但数据库assessment_answer表记录数为零原因这是一个典型的「事务未提交」问题。AssessmentService.saveAnswerBatch方法上缺了Transactional注解或者异常在事务内部被吞掉了。还有一种情况是前端传的studentId是字符串后端接收时类型转换失败静默处理了。解决在批量插入答案的方法上加Transactional(rollbackFor Exception.class)然后在submit接口返回前加一行日志log.info(学生{}提交测评{}共{}条答案, dto.getStudentId(), dto.getAssessmentId(), dto.getAnswerList().size());这样能立刻确认入参到底到了没有。5.4 现象论文里的 ER 图与代码里的数据表对不上原因这是很多套毕业设计资源的通病。论文是初版写的代码后来迭代过表格字段名改了但文档没更新。答辩时老师一眼就能看出实体关系图里user表和代码里student表不一致这是扣分重灾区。解决拿到资源后先做一次「数据库逆向对齐」——用秒针或者 Navicat 的逆向工程重新生成一份 ER 图对照论文的图做修正。我的习惯是直接把论文中涉及数据库结构的部分贴进新文档以实际 SQL 文件为准答辩时只说「论文中图表以最新数据库为准」完全没毛病。5.5 现象学生账号能直接调用管理员接口获取预约记录原因后端权限校验只做了登录拦截没有做角色等级判断。登录后拿到token就放行一切接口比如/api/reservation/admin/list这种接口学生也能访问。这个漏洞在答辩演示时如果被问起来会很尴尬。解决加一层 Spring Security 或者自定义拦截器按角色判断接口权限。最省事的办法是在HandlerInterceptor里维护一个adminOnly接口前缀列表请求路径以/admin/开头的必须校验当前用户角色为管理员否则返回 403。5.6 现象改了 uni-app 源码里的页面但微信开发者工具里没变化原因压缩包里的工程目录同时包含 uni-app 源码和编译后的dist产物。如果直接用微信开发者工具打开了dist目录你改的是源码目录开发者工具里看的一直是旧编译产物两边对不上白忙一下午。解决以 HBuilderX 打开源码根目录为准改完代码后重新点「运行到小程序模拟器」让 HBuilderX 重新编译覆盖 dist 输出。建议直接在微信开发者工具里把dist/dev路径关掉只保留 HBuilderX 自动打开的调试窗口。6. 答辩前的全链路验证把十个模块走成一条真实业务流6.1 一条龙走查从学生注册到咨询师回访答辩前两天我会强制按真实用户路径把系统走一遍顺序不能乱。以这套系统为例走查顺序是管理员登录后台 → 创建咨询师账号并启用 → 发布一条公告 → 设置首页轮播图 → 学生注册小程序端 → 查看公告 → 浏览轮播图 → 进入测评列表 → 完成一份心理健康测评 → 查看测评报告 → 根据报告推荐预约咨询师 → 提交预约单 → 切换咨询师账号查看预约请求 → 确认预约 → 学生端查看到预约状态变为已确认。这十五步能连续走通说明核心业务从数据流到权限都正常。6.2 用一条 SQL 和一段日志确认数据真的写进去了走查过程中不要只看页面「提交成功」的提示这个提示只能代表接口有响应。真正的数据落地验证我一般用 SQL 查三张核心表-- 1. 确认学生提交的测评答案是否存在 SELECT student_id, COUNT(*) AS answer_count FROM assessment_answer WHERE assessment_id 1 GROUP BY student_id; -- 2. 确认预约记录状态流转是否正确 SELECT id, student_id, counselor_id, status, create_time FROM reservation ORDER BY create_time DESC LIMIT 10; -- 3. 确认测评报告已生成分数和结论字段不为空 SELECT student_id, total_score, level, suggestion FROM assessment_result WHERE assessment_id 1;三条 SQL 分别对应测评、预约、结果三个主流程任何一条查不到记录都说明功能只走了前端表面没有真正落库。我自己的习惯是每跑完一步切换2-run.bat启动时开的控制台确认后端日志里没有ERROR或WARN级别的异常输出如果有哪怕是Exception caught级别的也要追根因很多隐性问题就是这么暴露的。6.3 三个拿得出手的「加分说明点」答辩时老师大概率会问「这个项目你具体做了什么」这三个点可以主动讲出来。第一测评答案批量提交用了批量插入 事务控制说明你理解数据一致性第二前端请求统一封装了 token 自动携带和 401 自动登出说明你理解前后端交互规范第三数据库设计按三范式拆分了学生、咨询师、测评、题目、答案、预约六张核心表说明你具备基础的数据建模能力。我到现在还记得自己毕业设计答辩前夜改数据库字段名改到凌晨两点第二天演示时因为改动没同步到论文图被评委追着问了三分钟的场景。从那以后我每次拿到新的毕设项目都强制走一遍「环境核对 → 数据库校对 → 全链路业务验证 → 文档对齐」这套流程数据通到哪文档就改到哪答辩前绝不心存侥幸。这套系统的坑我已经帮你踩过一圈了按上面流程走下来希望你答辩顺利也希望帮到你。本文还有配套的精品资源点击获取