简介这份资源是基于SSM框架开发的大学生心理健康平台完整项目源码面向计算机相关专业学生、Java初学者及需要毕业设计参考的开发者帮助解决心理健康类Web系统的选题与实现问题。项目采用JavaSSMMySQL技术栈围绕大学生、心理咨询师和管理员三类角色展开涵盖注册登录、个人信息维护、心理咨询师管理、站内新闻、心理测试、健康知识、心理咨询与心灵驿站等模块前台支持预约咨询与心理故事分享后台提供话题与用户管理。压缩包共1620个文件约80.62MB包含121个Java源文件、120个class编译文件、88个HTML页面、92个Vue组件、88个CSS样式、306个JS脚本以及SQL脚本、XML配置和图片素材等前后端结构完整。目前已有290人学习下载适合作为课程设计或毕业设计的参考方案可帮助读者快速理解SSM分层架构、数据库表设计与前后台交互流程并在此基础上进行二次开发与功能扩展。1. 从一份“大学生心理健康平台”需求说起SSM 到底能扛住什么每年毕业季总有一批同学被“基于SSM大学生心理健康平台的设计与实现”这个题目卡住。表面看是个常规的 Java Web 课设真动手才发现坑不少心理测评量表怎么存、咨询预约怎么防冲突、隐私数据怎么脱敏、辅导员和学生看到的数据权限怎么切。这些问题用纯 Servlet 写会写到怀疑人生用 Spring Boot 又容易被自动配置惯坏反而说不清底层发生了什么。SSMSpring SpringMVC MyBatis这套组合在校园项目里依然是性价比最高的选择IoC 帮你管住 Service 层的依赖SpringMVC 把请求路由和参数绑定理清楚MyBatis 让你对 SQL 有完全控制权——心理量表这种字段经常变、查询条件复杂的场景手写 SQL 比 ORM 自动生成靠谱得多。这篇笔记就按“一个真实能跑起来的心理健康平台”来拆从表结构、核心接口到部署排错把能抄的代码和能踩的坑都摆出来。适合正在做课设、毕设或者想用 SSM 练手一个完整业务系统的同学。2. 先定边界再动手心理平台的功能切分与表结构设计2.1 为什么心理平台不能照搬“增删改查”模板很多同学拿到题目第一反应是打开若依或者 SSM 脚手架把用户、角色、菜单三张表一建就开始写 CRUD。放到心理健康平台上这套模板会立刻暴露三个问题。第一心理测评不是普通表单。一份 SCL-90 量表有 90 道题每题 1 到 5 级评分提交后要按因子分躯体化、强迫症状、抑郁、焦虑等分别汇总还要和常模做对比。这意味着“测评记录”不能只存一个总分得存原始作答明细否则后期想换算法重算都做不到。第二咨询预约有强时序约束。同一个咨询师在同一时间段只能被一个学生占用而且学生不能同时预约两个咨询师。这种约束靠前端校验不够数据库层面得有唯一索引或者乐观锁兜底。第三隐私分级。学生只能看自己的测评报告和预约记录咨询师能看自己名下学生的报告辅导员能看所辖班级的预警名单管理员能看统计但不能看具体作答。这套权限用简单的角色菜单控制不住得在 Service 层做数据过滤。所以表结构设计要围绕“测评—预约—预警”三条主线展开而不是围绕“用户—角色—权限”展开。2.2 核心表结构与字段说明下面是我一般会用的最小可用表结构MySQL 8.0 环境下验证过。字段命名用下划线避免和 MyBatis 的驼峰映射打架。-- 学生表只存平台内必要信息敏感字段单独加密 CREATE TABLE student ( id bigint NOT NULL AUTO_INCREMENT, student_no varchar(20) NOT NULL COMMENT 学号登录账号, password varchar(100) NOT NULL COMMENT BCrypt 加密后的密码, real_name varchar(50) NOT NULL, college varchar(50) DEFAULT NULL, class_name varchar(50) DEFAULT NULL, phone_enc varchar(200) DEFAULT NULL COMMENT AES 加密手机号, status tinyint DEFAULT 1 COMMENT 1正常 0禁用, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_student_no (student_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 量表定义表支持多套量表共存 CREATE TABLE scale ( id bigint NOT NULL AUTO_INCREMENT, scale_code varchar(30) NOT NULL COMMENT 如 SCL90、SDS, scale_name varchar(100) NOT NULL, question_count int NOT NULL, factor_rule json DEFAULT NULL COMMENT 因子归属规则JSON 存, status tinyint DEFAULT 1, PRIMARY KEY (id), UNIQUE KEY uk_scale_code (scale_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 测评记录主表 CREATE TABLE assessment_record ( id bigint NOT NULL AUTO_INCREMENT, student_id bigint NOT NULL, scale_id bigint NOT NULL, total_score decimal(6,2) DEFAULT NULL, risk_level tinyint DEFAULT 0 COMMENT 0正常 1关注 2预警 3高危, submit_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_student_scale (student_id,scale_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 作答明细表一题一行方便重算 CREATE TABLE assessment_answer ( id bigint NOT NULL AUTO_INCREMENT, record_id bigint NOT NULL, question_no int NOT NULL, score tinyint NOT NULL, PRIMARY KEY (id), KEY idx_record (record_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 咨询师表 CREATE TABLE counselor ( id bigint NOT NULL AUTO_INCREMENT, name varchar(50) NOT NULL, title varchar(50) DEFAULT NULL, max_daily int DEFAULT 6 COMMENT 每日最大预约数, status tinyint DEFAULT 1, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 预约表用唯一索引防重复占位 CREATE TABLE appointment ( id bigint NOT NULL AUTO_INCREMENT, student_id bigint NOT NULL, counselor_id bigint NOT NULL, appoint_date date NOT NULL, time_slot tinyint NOT NULL COMMENT 1-8 对应八个时段, status tinyint DEFAULT 0 COMMENT 0待确认 1已确认 2已完成 3已取消, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_counselor_slot (counselor_id,appoint_date,time_slot,status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里有几个参数值得单独说。phone_enc用 AES 加密而不是明文是因为心理平台一旦泄露手机号后果比普通课设严重得多。factor_rule用 JSON 字段存因子归属好处是换量表不用改表结构坏处是 MyBatis 默认不支持 JSON 类型映射需要在mybatis-config.xml里注册自定义 TypeHandler或者直接用String接收再在 Service 层解析。appointment表的唯一索引把status也包进去了这是为了让“已取消”的记录不占用时段——但要注意MySQL 唯一索引对 NULL 不生效所以status必须给默认值 0不能允许 NULL。2.3 工程分层与依赖版本SSM 项目最容易翻车的地方是版本冲突。Spring 5.x 和 MyBatis 3.5.x 搭配比较稳SpringMVC 的 JSON 转换用 Jackson 2.13 以上。下面是我常用的pom.xml关键依赖片段。properties spring.version5.3.30/spring.version mybatis.version3.5.14/mybatis.version jackson.version2.15.3/jackson.version /properties dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version${spring.version}/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-jdbc/artifactId version${spring.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version${mybatis.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.1.2/version /dependency dependency groupIdcom.fasterxml.jackson.core/groupId artifactIdjackson-databind/artifactId version${jackson.version}/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency dependency groupIdcom.zaxxer/groupId artifactIdHikariCP/artifactId version4.0.3/version /dependency /dependenciesmybatis-spring的版本要和 MyBatis 主版本对齐2.1.x 对应 MyBatis 3.5.x用错了会在启动时报NoClassDefFoundError。HikariCP 4.x 支持 JDK 8如果学校机房还是 JDK 8 环境别升到 5.x。连接池的maximumPoolSize在课设场景设 10 就够设太大反而容易把实验室的 MySQL 连接数打满。3. 测评提交与因子分计算MyBatis 批量写入和 Service 层算法3.1 测评提交的完整链路学生点“提交”之后后端要做四件事校验是否重复提交、保存主记录、批量保存作答明细、计算因子分并回写风险等级。这四步必须在一个事务里否则会出现“主记录有了但明细丢了”的脏数据。Controller 层只负责接参数和返回结果不写业务逻辑。RestController RequestMapping(/api/assessment) public class AssessmentController { Autowired private AssessmentService assessmentService; PostMapping(/submit) public Result submit(RequestBody SubmitDTO dto, HttpSession session) { Long studentId (Long) session.getAttribute(studentId); if (studentId null) { return Result.fail(未登录); } // 幂等同一学生同一量表 5 分钟内只允许提交一次 if (assessmentService.isDuplicate(studentId, dto.getScaleId())) { return Result.fail(请勿重复提交); } Long recordId assessmentService.submit(studentId, dto); return Result.ok(recordId); } }SubmitDTO里包含scaleId和一个ListAnswerItem每个AnswerItem有questionNo和score。这里不要用 Map 接收Map 的 key 顺序不可控批量插入时容易和题目编号错位。3.2 Service 层事务与因子分算法因子分计算是心理平台和普通 CRUD 最大的区别。以 SCL-90 为例90 道题归属到 9 个因子每个因子分等于该因子下所有题目得分之和除以题目数。风险等级一般按总分或阳性项目数来判不同学校标准不一样所以算法要可配置。Service public class AssessmentServiceImpl implements AssessmentService { Autowired private AssessmentRecordMapper recordMapper; Autowired private AssessmentAnswerMapper answerMapper; Autowired private ScaleMapper scaleMapper; Override Transactional(rollbackFor Exception.class) public Long submit(Long studentId, SubmitDTO dto) { Scale scale scaleMapper.selectById(dto.getScaleId()); if (scale null) { throw new BizException(量表不存在); } // 1. 保存主记录 AssessmentRecord record new AssessmentRecord(); record.setStudentId(studentId); record.setScaleId(dto.getScaleId()); record.setSubmitTime(new Date()); recordMapper.insert(record); // 2. 批量保存明细 ListAssessmentAnswer answers new ArrayList(); for (AnswerItem item : dto.getAnswers()) { AssessmentAnswer ans new AssessmentAnswer(); ans.setRecordId(record.getId()); ans.setQuestionNo(item.getQuestionNo()); ans.setScore(item.getScore()); answers.add(ans); } answerMapper.batchInsert(answers); // 3. 计算因子分和风险等级 MapString, Double factorScores calcFactorScores(scale, dto.getAnswers()); int riskLevel judgeRisk(scale.getScaleCode(), factorScores); record.setTotalScore(calcTotal(dto.getAnswers())); record.setRiskLevel(riskLevel); recordMapper.updateById(record); return record.getId(); } private MapString, Double calcFactorScores(Scale scale, ListAnswerItem answers) { // factor_rule 是 JSON形如 {躯体化:[1,4,12,...], 强迫症状:[...]} JSONObject rule JSON.parseObject(scale.getFactorRule()); MapInteger, Integer scoreMap answers.stream() .collect(Collectors.toMap(AnswerItem::getQuestionNo, AnswerItem::getScore)); MapString, Double result new HashMap(); for (String factor : rule.keySet()) { JSONArray arr rule.getJSONArray(factor); double sum 0; for (int i 0; i arr.size(); i) { sum scoreMap.getOrDefault(arr.getInteger(i), 0); } result.put(factor, sum / arr.size()); } return result; } }Transactional的rollbackFor一定要写Exception.class因为 Spring 默认只对RuntimeException回滚业务里抛的BizException如果是受检异常不回滚就会留下半截数据。batchInsert的 SQL 用foreach拼单次插入不要超过 500 条SCL-90 的 90 条完全没问题但如果是超长量表要分批。3.3 MyBatis 批量插入的 XML 写法insert idbatchInsert parameterTypejava.util.List INSERT INTO assessment_answer (record_id, question_no, score) VALUES foreach collectionlist itemitem separator, (#{item.recordId}, #{item.questionNo}, #{item.score}) /foreach /insertcollectionlist是 MyBatis 对 List 参数的默认命名如果 Mapper 方法用了Param(answers)这里要改成collectionanswers。separator,不能漏漏了会拼出VALUES (...)(...)这种语法错误。批量插入的 JDBC URL 建议加上rewriteBatchedStatementstrue否则 MySQL 驱动会一条条发性能差好几倍。4. 预约冲突与权限过滤那些课设里没人告诉你的坑4.1 预约时段的并发冲突怎么防预约功能最典型的翻车场景两个学生同时点同一个咨询师的同一个时段前端都显示“可预约”后端都执行 insert结果数据库里出现两条记录。唯一索引能挡住但抛出来的是DuplicateKeyException直接返给前端就是 500 错误体验很差。正确做法是在 Service 层捕获这个异常转成友好提示。Override public Result appoint(Long studentId, Long counselorId, Date date, Integer slot) { try { Appointment app new Appointment(); app.setStudentId(studentId); app.setCounselorId(counselorId); app.setAppointDate(date); app.setTimeSlot(slot); app.setStatus(0); appointmentMapper.insert(app); return Result.ok(预约成功等待确认); } catch (DuplicateKeyException e) { // 唯一索引冲突说明时段已被占 return Result.fail(该时段已被预约请选择其他时间); } }这里有个细节唯一索引包含了status所以“已取消”的记录不会挡住新预约。但如果学生取消后重新预约同一时段status从 3 变成 0唯一索引会认为这是新记录没问题。真正要小心的是“已确认”和“待确认”都算占用所以status为 0 和 1 的记录不能同时存在同一时段——这靠唯一索引本身保证不了因为索引把 status 也当成了区分维度。稳妥做法是加一个active_flag字段待确认和已确认都置 1取消置 0唯一索引建在(counselor_id, appoint_date, time_slot, active_flag)上。4.2 数据权限过滤的三种实现层次心理平台的数据权限比普通系统敏感学生 A 不能看到学生 B 的测评报告。常见做法有三种我一般按场景混用。第一种是 SQL 层过滤在 Mapper 方法里强制带上student_id条件。优点是简单直接缺点是每个查询都要记得加漏一个就出事故。select idselectMyRecords resultTypeAssessmentRecord SELECT * FROM assessment_record WHERE student_id #{studentId} ORDER BY submit_time DESC /select第二种是 Service 层校验查到记录后判断record.getStudentId()是否等于当前登录用户。适合详情页这种按 ID 查询的场景。第三种是注解 AOP自定义DataScope注解在切面里根据当前用户角色拼接 SQL 片段。这套在若依里很成熟但课设里手写一遍能加分不少。核心思路是在 MyBatis 的Interceptor里拦截Executor.query拿到 MappedStatement 的 ID判断是否带了数据权限标记然后动态改写 SQL。4.3 心理预警的触发与通知风险等级算出 2 或 3 之后要触发预警。预警不是简单发个站内信得考虑谁来看、多久看一次、看了之后做什么。我一般会建一张warning_log表记录预警产生时间、处理人、处理状态。辅导员登录后看到的是“待处理预警列表”处理完要填处理意见。这个闭环不做预警就是个摆设。通知方式上课设环境用站内信最稳不要接短信或邮件一来要申请账号二来容易在答辩现场翻车。站内信表结构简单receiver_id、content、is_read、create_time四个字段就够。5. 避坑与排查SSM 心理平台最常见的五类翻车5.1 中文乱码从 Controller 一路乱到数据库现象提交测评后数据库里量表名称显示为???前端页面也是乱码。原因三层都可能出问题。Tomcat 的URIEncoding没设成 UTF-8SpringMVC 的StringHttpMessageConverter默认用 ISO-8859-1MySQL 连接串没加characterEncodingutf8。解决Tomcat 的server.xml里 Connector 加URIEncodingUTF-8SpringMVC 配置里加mvc:message-converters把 String 转换器改成 UTF-8JDBC URL 写成jdbc:mysql://localhost:3306/psy?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai。三处都改完再重启缺一处都还会乱。5.2 事务不生效明细表插入了但主表回滚了现象测评提交时如果因子分计算抛异常主记录回滚了但作答明细还在。原因Transactional加在了 Controller 上或者 Service 类没有被 Spring 代理比如自己 new 出来的或者异常被 catch 了没重新抛。解决注解加在 Service 实现类的方法上确保该类被context:component-scan扫到catch 块里如果要处理异常处理完必须throw new RuntimeException(e)或者用TransactionAspectSupport.currentTransactionStatus().setRollbackOnly()。最稳的排查方式是打开 Spring 的事务日志logging.level.org.springframework.jdbcDEBUG看有没有Creating new transaction和Rolling back的输出。5.3 MyBatis 的#{}和${}用混导致 SQL 注入现象排序字段用${}接收前端参数被安全扫描扫出注入风险。原因#{}是预编译占位符${}是字符串拼接。排序字段、表名这种不能用#{}的地方如果直接拼前端传的值就是注入点。解决排序字段用白名单校验只允许submit_time、total_score这几个固定值其他一律拒绝。实在要用${}在 Service 层做正则匹配只放行[a-zA-Z_]。5.4 连接池耗尽页面卡死现象答辩演示时多人同时访问页面转圈日志报Connection is not available。原因HikariCP 的maximumPoolSize设太小或者有代码拿了连接没关MyBatis 一般不会但手写 JDBC 会。解决课设环境maximumPoolSize设 10 到 20connectionTimeout设 30000。排查时看 HikariCP 的 JMX 指标或者日志里的total10, active10, idle0, waiting5waiting 大于 0 就说明池子不够。另外检查有没有在循环里调 Mapper 查询这种 N1 问题会把连接占满。5.5 量表因子分算出来和常模对不上现象SCL-90 总分算出来 180但常模标准是 160 以上为阳性系统判成了正常。原因总分算法用错了。SCL-90 的总分是 90 题得分之和但阳性筛查标准是“总分超过 160 分”或“阳性项目数超过 43 项”两个条件满足其一即可。只按总分判会漏掉一部分。解决把判定规则做成可配置的 JSON存在scale表的factor_rule里包含totalThreshold、positiveCountThreshold、factorThreshold三个维度。判定时三个条件或关系任一满足就升级风险等级。这样换量表只改配置不改代码。6. 让平台经得起追问从课设到可演示的进阶技巧6.1 用拦截器做操作日志答辩时能拿出证据课设答辩最怕老师问“你怎么证明这个操作是谁做的”。加一个 MyBatis 拦截器拦截Executor.update把 SQL、参数、当前登录用户、时间戳记到operation_log表。代码不长但演示时能直接查出来“张三在 3 月 5 日提交了 SCL-90”说服力完全不一样。Intercepts({Signature(type Executor.class, method update, args {MappedStatement.class, Object.class})}) public class LogInterceptor implements Interceptor { Override public Object intercept(Invocation invocation) throws Throwable { MappedStatement ms (MappedStatement) invocation.getArgs()[0]; Object param invocation.getArgs()[1]; // 只记录业务表的写操作排除日志表自身 if (!ms.getId().contains(OperationLogMapper)) { OperationLog log new OperationLog(); log.setMapperId(ms.getId()); log.setParams(JSON.toJSONString(param)); log.setUserId(UserContext.getCurrentUserId()); log.setCreateTime(new Date()); // 异步写入避免影响主流程 logService.asyncSave(log); } return invocation.proceed(); } }UserContext用 ThreadLocal 存当前请求的用户 ID在 SpringMVC 拦截器的preHandle里塞进去afterCompletion里清掉。异步写入用Async或者简单的ExecutorService别在主线程里同步插日志否则测评提交会变慢。6.2 用 H2 内存库做单元测试不依赖本地 MySQL答辩前最怕数据库连不上。把 Mapper 层的测试切到 H2 内存库建表 SQL 和 MySQL 基本兼容spring-test里配一个DataSource指向 H2跑测试时自动建表插数据。这样即使实验室断网或者 MySQL 服务挂了测试照样能跑。RunWith(SpringJUnit4ClassRunner.class) ContextConfiguration(locations classpath:spring-test.xml) Transactional public class AssessmentMapperTest { Autowired private AssessmentAnswerMapper answerMapper; Test public void testBatchInsert() { ListAssessmentAnswer list new ArrayList(); for (int i 1; i 90; i) { AssessmentAnswer a new AssessmentAnswer(); a.setRecordId(1L); a.setQuestionNo(i); a.setScore(i % 5 1); list.add(a); } int rows answerMapper.batchInsert(list); Assert.assertEquals(90, rows); } }Transactional加在测试类上每个测试方法跑完自动回滚不会污染数据。H2 的 MySQL 兼容模式要在 URL 里加MODEMySQL否则AUTO_INCREMENT和ENGINEInnoDB这些语法会报错。6.3 一个我踩过的坑别在答辩前一天改表结构最后说个血泪经验。有次帮学弟调平台他答辩前一天觉得assessment_answer表应该加个factor_name字段方便查询。改完表结构MyBatis 的resultMap没同步更新所有测评查询全部报Column not found。连夜回滚差点没赶上答辩。后来我养成的习惯是表结构变更必须走三步——先改 SQL 脚本并备份再改实体类和 Mapper XML最后跑一遍全量回归测试。三步缺一步都不行。课设时间紧但这一步省不得。希望帮到你。本文还有配套的精品资源点击获取