简介：这是一份面向计算机专业毕业设计或课程项目的Java学业帮扶管理系统完整源码包，基于SSM框架与JSP技术构建，搭配MySQL数据库与JDK1.8环境，可使用Eclipse、MyEclipse、STS或IDEA导入运行，适合需要快速完成管理类项目的学生作为参考。系统覆盖个人中心、家长管理、学生管理、教师管理、成绩信息管理、成绩预警管理、会议信息管理等模块，并涵盖不同角色的基本数据管理与预警流程，能支撑学业帮扶场景下的常见业务需求。资源包共845个文件，大小约23.38MB，主要包含Java源码、JSP页面、SQL数据库脚本、前端JS/CSS样式、HTML页面、XML配置文件以及字体图片素材，内含完整工程目录结构与环境工具包，另附说明文档和操作视频，能帮助使用者从环境配置、数据库导入到项目部署逐步上手。目前已有90人学习/下载，对筹备毕业设计或学习SSM整合应用的开发者很有参考价值。
1. 毕业设计选中“学业帮扶管理系统”，SSM+JSP 源码里最该先读哪一部分
每年毕业设计季，“毕业设计 java 学业帮扶管理系统 ssm jsp web 源码含教程”都会成为高频搜索词，相关检索里还带出 java 课程设计案例源码、基于 jsp 的毕设选题、idea 新建 jsp 项目这些长尾需求。这说明大家要的不是一篇项目介绍，而是一份能导入电脑、能跑通、能讲清楚、能写进论文的技术方案。这个系统做的是高校学困生管理：学生成绩进来，系统按规则筛出挂科或有学业风险的学生，教师认领帮扶任务、记录帮扶过程、跟踪效果，管理员做课程、用户和统计管理。
技术上 SSM 加 JSP 是有点“老”的组合，但老组合恰恰适合做毕业设计：Spring 管依赖和事务，SpringMVC 管请求分发，MyBatis 管 SQL，JSP 做页面，每一层边界清楚，答辩证时不会变成黑匣子。拿到源码包后，我建议你先别急着点 Run。先看三样东西：SQL 脚本、配置文件、业务表关系。把这三样摸清，项目能不能跑、跑起来后该点哪里，你心里基本就有数了。
这篇文章就按这个顺序写：先设计数据库，再搭项目，再实现“学业预警与帮扶”这条核心功能线，最后讲传统 JSP 项目打包 war 时最容易踩的坑。适合正在做毕设选题、javaweb 课程设计，或者刚学完 ssm 框架想拿完整项目练手的人。
2. 先立业务骨架：学业帮扶管理系统的 6 张核心表怎么设计
2.1 业务模块怎么拆：三种角色和一条帮扶主线
拿到需求先别急着建表，先把角色和流程理顺。学业帮扶管理系统里有三类用户：管理员维护课程、教师账号和基础数据；教师录入学生成绩、查看预警名单、填写帮扶记录；学生只能查看自己的成绩、预警信息和帮扶历史。权限差异决定了登录表不能只做一张简单的“学生表带账号密码”，而是要拆出一张独立的用户表来支撑登录。
业务主线可以描述成一条链路：成绩进入系统 → 按学期和规则找出挂科或学分不足的学生 → 生成预警名单 → 教师认领帮扶任务 → 记录每次帮扶内容 → 按效果决定是否关闭任务。这条链路里，学生、课程、成绩是静态基础数据，预警和帮扶是动态过程数据。基础数据和过程数据分开建表，后面做统计和换学期重算时都方便。
我的习惯是先把这条链路上每一步需要的字段写在纸上，再映射成表。比如“教师认领帮扶任务”这一条，就需要记录哪个教师、哪个学生、什么学期、什么时间、聊了什么、效果如何、当前状态。把这些字段放进一张帮扶记录表，比散落在多张临时表里好讲得多。
2.2 建库脚本：sys_user、student、course、score、help_record
下面这套脚本我建议按自己的字段命名习惯再改一遍，但表结构关系可以直接用。注意我把密码放进了 sys_user 表，而不是 student 表，因为教师和管理员也需要登录，三张用户表会带来无谓的关联查询。
-- 学业帮扶管理系统核心表（MySQL 5.7+，字符集 utf8mb4） CREATE TABLE sys_user ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT '主键', username VARCHAR(30) NOT NULL COMMENT '登录账号', password VARCHAR(64) NOT NULL COMMENT '登录密码，存 MD5 或加盐后的值', user_type VARCHAR(16) NOT NULL COMMENT 'ROLE_ADMIN / ROLE_TEACHER / ROLE_STUDENT', real_name VARCHAR(30) COMMENT '真实姓名，冗余方便显示', status TINYINT DEFAULT 1 COMMENT '1 启用 0 禁用', create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间' ) COMMENT='系统用户表'; CREATE TABLE student ( id INT PRIMARY KEY COMMENT '关联 sys_user.id', student_no VARCHAR(20) NOT NULL UNIQUE COMMENT '学号', class_name VARCHAR(64) COMMENT '班级', major_name VARCHAR(64) COMMENT '专业', enroll_year INT COMMENT '入学年份' ) COMMENT='学生信息表'; CREATE TABLE teacher ( id INT PRIMARY KEY COMMENT '关联 sys_user.id', teacher_no VARCHAR(20) NOT NULL UNIQUE COMMENT '工号', dept_name VARCHAR(64) COMMENT '院系', title VARCHAR(32) COMMENT '职称，可选' ) COMMENT='教师信息表'; CREATE TABLE course ( id INT PRIMARY KEY AUTO_INCREMENT, course_name VARCHAR(64) NOT NULL COMMENT '课程名称', credit DECIMAL(3,1) COMMENT '学分', is_required TINYINT DEFAULT 1 COMMENT '1 必修 0 选修' ) COMMENT='课程表'; CREATE TABLE score ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT NOT NULL COMMENT '关联 student.id', course_id INT NOT NULL COMMENT '关联 course.id', semester VARCHAR(16) NOT NULL COMMENT '学年学期，如 2024-2025-1', score DECIMAL(5,2) NOT NULL COMMENT '课程成绩，0-100', UNIQUE KEY uk_stu_course_sem (student_id, course_id, semester) ) COMMENT='选课成绩表'; CREATE TABLE help_record ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT NOT NULL, teacher_id INT NOT NULL COMMENT '帮扶教师', semester VARCHAR(16) NOT NULL, help_date DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '帮扶时间', content TEXT COMMENT '帮扶内容，面谈/辅导记录', effect_desc VARCHAR(255) COMMENT '帮扶效果说明', status VARCHAR(16) DEFAULT '待跟进' COMMENT '待跟进/帮扶中/已结束' ) COMMENT='帮扶记录表';字段说明里最值得关注的是 score 表唯一键uk_stu_course_sem。同一个学生在同一学期同一门课只允许一条成绩，这个约束既防止重复录分，也让后面“按学期统计不及格门数”的查询结果稳定。另外大家要注意，password 字段长度设 64 是为了容纳 MD5 或简单加盐结果，如果将来要用 BCrypt，长度要扩到 128 以上。
2.3 表设计里最常见的三个问题：为什么不把密码放学生表
很多课程设计会把 username 和 password 直接放进 student 表，因为“只有学生登录”。但只要加入教师和管理员角色，就会面临三种处理方式：建三张用户表、建一张用户表加角色、或者所有角色挤在一张表里用字段区分。我的建议是 sys_user 独立出来，student.id 和 teacher.id 都去关联 sys_user.id，用户表只负责登录认证，个人信息表只负责业务数据，职责单一，后期做角色权限也好下手。
第二个常见问题是 score 表不保存 semester。学生每个学期都可能修同一门课，如果成绩表没有学期字段，算补考、算重修、算每个学期的不及格门数都会出错。加了学期字段还不够，建议把(student_id, course_id, semester)做成唯一键，这是我从实际项目里得到的教训：教师重复录分时，数据库会直接挡住错误数据，而不是让统计结果莫名翻倍。
第三个容易忽略的地方是帮扶记录表。有的同学觉得只要“查出挂科名单”就算完成了学业帮扶，能省一张表省一张。但答辩时导师大概率会问：预警之后做了什么？谁在跟进？效果怎么评估？这些信息都存在 help_record 里。它的 status 字段替代了单独建一张“预警状态表”的做法，一条帮扶任务从待跟进到已结束，状态流转足够清楚，也不用为临时状态建额外表。如果你后面想扩展“重点帮扶对象”，在 help_record 上加 aid_level 字段就行。
提示：导入 SQL 时如果报中文乱码或建表失败，优先检查数据库字符集是否为 utf8mb4，以及是否已经选中了目标库。执行
SET NAMES utf8mb4;后再跑脚本，基本能消除这类问题。
3. 用 IDEA 新建 SSM+JSP 项目：pom.xml 与三个配置文件的闭环
3.1 Maven 坐标对齐：spring-webmvc、spring-jdbc、mybatis 的版本怎么配
从 idea 新建 jsp 项目开始，最省事的做法不是手建目录，而是用 Maven 的maven-archetype-webapp骨架创建，再补上 SSM 依赖。这里最容易翻车的是版本乱配：Spring、MyBatis、MyBatis-Spring 三者版本不匹配，启动时会出现各种NoSuchMethodError或ClassNotFoundException。下面这组依赖是我常用的组合，版本彼此兼容，可以作为起点：
<!-- pom.xml 关键依赖，版本可根据你电脑本地的 Maven 仓库调整 --> <project> <groupId>com.eduhelp</groupId> <artifactId>academic-help</artifactId> <packaging>war</packaging> <properties> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> <spring.version>5.2.22.RELEASE</spring.version> <mybatis.version>3.5.9</mybatis.version> </properties> <dependencies> <!-- Spring MVC 与 Spring JDBC 在 spring-webmvc 体系下一起工作 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>${spring.version}</version> </dependency> <!-- MyBatis 核心 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>${mybatis.version}</version> </dependency> <!-- MyBatis 与 Spring 集成 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>2.0.6</version> </dependency> <!-- MySQL 驱动，版本要与本地数据库一致 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.29</version> </dependency> <!-- JSP 页面用 JSTL 做循环和条件判断 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> <!-- Servlet API 由 Tomcat 提供，打包时不需要打进去 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>4.0.1</version> <scope>provided</scope> </dependency> </dependencies> </project>两个参数值得注意：spring-jdbc必须加，因为事务管理器DataSourceTransactionManager在 spring-jdbc 包中；javax.servlet-api设为provided，否则打 war 包里会带一份 Servlet API，和 Tomcat 自带版本冲突，启动时容易出现奇怪异常。JSTL 的坐标是javax.servlet:jstl:1.2，很多人会写成jstl:jstl:1.2，坐标会拉不下来。
3.2 web.xml、applicationContext.xml、spring-mvc.xml 三者的分工与写法
传统 SSM 项目里配置文件多，但真正决定项目能不能起来的是 web.xml 和两份 Spring 配置。web.xml 是整个 Web 应用的入口，负责加载 Spring 容器和分发请求；applicationContext.xml 管数据源、MyBatis、Service；spring-mvc.xml 只管 Controller 和视图解析器。这样拆是避免 Controller 被扫描两次导致事务失效。
<!-- web.xml：项目入口，放在 src/main/webapp/WEB-INF 下 --> <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0"> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <!-- 编码过滤器：必须在所有过滤器前面 --> <filter> <filter-name>encodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>encodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!-- Spring 根容器 --> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:applicationContext.xml</param-value> </context-param> <!-- SpringMVC 核心控制器 --> <servlet> <servlet-name>dispatcher</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring-mvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>dispatcher</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>这里有个知识点容易被忽视：ContextLoaderListener加载根容器，DispatcherServlet加载 spring-mvc.xml，后者是前者的子容器。子容器能看到父容器的 Bean，父容器看不到子容器的 Bean。所以 Service 配在 applicationContext.xml，Controller 配在 spring-mvc.xml，事务切点才能正常作用到 Service 上。
<!-- spring-mvc.xml：只管请求分发和视图 --> <context:component-scan base-package="com.eduhelp.controller"/> <mvc:annotation-driven/> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/views/"/> <property name="suffix" value=".jsp"/> </bean> <mvc:resources mapping="/static/**" location="/static/"/>InternalResourceViewResolver的前缀我固定写/WEB-INF/views/，JSP 放到 WEB-INF 下外部无法直接访问，必须通过 Controller 跳转，对毕设项目来说安全性和规范性都够。静态资源单独放/static/目录，并用mvc:resources放行，否则 CSS、JS 会被 DispatcherServlet 拦截导致样式全丢。
3.3 最小验证：Controller 返回一个 JSP 页面，确认三层链路已经走通
新项目别急着写业务功能，先做最小验证：数据库连上、页面能渲染、从请求到返回的链路通顺。我习惯先做一个“学生列表”页面来验证，因为一句话的 Hello World 验证不了 MyBatis 和数据库。
package com.eduhelp.controller; import com.eduhelp.entity.Student; import com.eduhelp.service.StudentService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.RequestMapping; import java.util.List; @Controller @RequestMapping("/student") public class StudentController { @Autowired private StudentService studentService; @RequestMapping("/list") public String list(Model model) { List<Student> students = studentService.listAll(); model.addAttribute("students", students); return "student/list"; } }return "student/list"会由视图解析器拼成/WEB-INF/views/student/list.jsp。如果启动后访问/student/list报 404，先看 IDEA 控制台里 Tomcat 部署的上下文路径，再确认 JSP 确实放在对应目录下。这一步跑通，后面加业务模块就只是复制这条链路。
提示：首次导入项目时，如果 IDEA 右上角没有 Tomcat 配置，需要先在 Run 配置里新增 Tomcat Server，并选择 Local 模式。
4. 把“学业预警与帮扶”做成能演示的功能：规则、查询与页面
4.1 预警规则怎么定：按课程不及格、按学分缺口、按学期累计
学业预警不能拍脑袋说“成绩低于 60 就预警”，那是查询不是规则。常见的预警口径有三种：课程不及格、学期累计不及格学分超限、学习成绩较上学期明显下滑。三种口径可以在代码里做成一个规则类，字段由管理员配置。
第一种“课程不及格”最简单，score < 60就触发；第二种“累计不及格学分超限”要先把学分和成绩关联，假设一门必修课 4 学分，挂 2 门就是 8 学分缺口，超过阈值就重点帮扶；第三种适合有历史成绩的系统，用当前学期平均分比上一学期下降超过 15% 来判断。毕业设计能实现前两种已经很完整，第三种作为扩展点在论文里提出即可。
务实的做法是把阈值抽到一张配置表或 properties 文件里，不要在 Java 代码里写死“2 门、60 分”这些数字。这样演示时可以直接把阈值从 2 改成 1，页面结果马上变化，说服力远大于口述逻辑。
4.2 用 MyBatis 联表查出“需要帮扶的学生名单”
预警功能的核心是一句联表统计 SQL。我这里按“指定学期内不及格课程数大于等于阈值”来写，所有参数都走#{}传参，避免拼接 SQL 带来的注入风险。
<!-- WarnMapper.xml --> <mapper namespace="com.eduhelp.mapper.WarnMapper"> <!-- 查询指定学期挂科门数超过阈值的名单 --> <select id="listWarnStudents" resultType="com.eduhelp.vo.WarningVO"> SELECT s.id AS studentId, s.student_no AS studentNo, s.real_name AS realName, s.class_name AS className, COUNT(sc.id) AS failCourseCount FROM student s INNER JOIN score sc ON sc.student_id = s.id WHERE sc.score < 60 AND sc.semester = #{semester} GROUP BY s.id, s.student_no, s.real_name, s.class_name HAVING COUNT(sc.id) >= #{threshold} ORDER BY failCourseCount DESC </select> </mapper>两句关键点说明：XML 里写小于号必须用<，直接用<会导致 XML 解析失败；HAVING是在GROUP BY之后过滤，和WHERE的过滤时机完全不同，这里threshold不能挪到 WHERE 里。WarningVO是一个视图对象，字段用驼峰命名，与 SELECT 里的别名对应，避免把实体表结构硬塞进来。Service 层拿到 list 后，还要做一步去重判断，防止同一个学生被重复生成帮扶任务：
@Service public class WarningService { @Autowired private WarnMapper warnMapper; @Autowired private HelpRecordMapper helpRecordMapper; @Transactional public int generateHelpTasks(String semester, int threshold) { List<WarningVO> warnList = warnMapper.listWarnStudents(semester, threshold); int created = 0; for (WarningVO w : warnList) { Integer pending = helpRecordMapper.countByStudentAndSemester( w.getStudentId(), semester, "待跟进"); if (pending != null && pending > 0) { continue; } HelpRecord record = new HelpRecord(); record.setStudentId(w.getStudentId()); record.setSemester(semester); record.setContent("系统自动生成预警，挂科 " + w.getFailCourseCount() + " 门"); record.setStatus("待跟进"); helpRecordMapper.insert(record); created++; } return created; } }countByStudentAndSemester查询是幂等保护的关键。很多毕设在这个环节只做了插入，没有先查“待跟进”记录，导致教师点击“生成帮扶任务”两次，学生名下出现两条重复任务。真实教学场景里，一次预警对应一次帮扶周期，重复数据会让后期统计完全失去参考价值。
4.3 JSP 页面用 JSTL 渲染预警名单，并把“重点帮扶”标签区分出来
预警结果展示不需要前端框架，JSP 加 JSTL 足够。页面里我使用<c:forEach>循环名单，再通过<c:choose>按挂科门数分级显示“重点帮扶”或“一般帮扶”。
<%@ page contentType="text/html;charset=UTF-8" language="java" %> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <html> <head> <title>学业预警名单</title> </head> <body> <table class="table table-bordered"> <thead> <tr> <th>学号</th> <th>姓名</th> <th>班级</th> <th>挂科门数</th> <th>帮扶级别</th> </tr> </thead> <tbody> <c:forEach items="${warnList}" var="w"> <tr> <td>${w.studentNo}</td> <td>${w.realName}</td> <td>${w.className}</td> <td>${w.failCourseCount}</td> <td> <c:choose> <c:when test="${w.failCourseCount >= 4}">重点帮扶</c:when> <c:when test="${w.failCourseCount >= 2}">一般帮扶</c:when> <c:otherwise>关注</c:otherwise> </c:choose> </td> </tr> </c:forEach> </tbody> </table> </body> </html>页面本身并不复杂，但这里有一个容易被忽略的规范问题：JSP 顶部一定要声明pageEncoding="UTF-8"，否则浏览器以默认编码解析页面，中文字符会显示成乱码。${w.failCourseCount}取的是 WarningVO 的属性值，MyBatis 会自动调用对应 getter，所以要确认 VO 的属性名与 Mapper 中别名完全一致，比如className不能写类属性clazz。
5. 避坑：传统 JSP 项目从本地运行到打包 War 的 5 个典型问题
5.1 JSP 页面 404，或访问路径直接跳到了 Tomcat 默认首页
现象：项目能在 IDEA 里启动，但浏览器输http://localhost:8080/student/list后要么 404，要么进入 Tomcat 欢迎页，完全没有进入业务系统。原因大多数出在两类地方：一是部署的上下文路径不对，IDEA 默认会带/academic-help_war_exploded/这种后缀，路径少写一段就找不到应用；二是web.xml的 welcome-file 指向了不存在的页面，比如写了index.jsp但该文件在/WEB-INF/views/下，Tomcat 找不到欢迎页会退回默认页。
解决：先在 IDEA 的 Deployment 标签页里看 Actual path 是什么，把访问地址改为http://localhost:8080/项目名/student/list。welcome 页面不要直接指 WEB-INF 下的 JSP，而是写一个根目录index.jsp，里面做response.sendRedirect(request.getContextPath() + "/student/list")跳转。上下文路径的问题属于血泪经验，每届都能遇到一批。
5.2 数据库字段 user_name 映射到实体 userName 结果全是 null
现象：数据库查得出记录，studentList也有数据，但页面里studentNo、userName这类带下划线的字段全部是 null，没有下划线的字段反而正常。原因：MyBatis 默认不开启下划线转驼峰，数据库里的student_no和实体里的studentNo是两回事，自动映射对不上就只给 null。
解决：在 MyBatis 全局配置中加一行设置，<setting name="mapUnderscoreToCamelCase" value="true"/>，同时保证实体属性命名严格按驼峰规则。如果用了resultMap，则要手动写column="student_no" property="studentNo"。我一般会在 Mapper 的 SELECT 语句里顺手写别名，比如s.student_no AS studentNo，三层保险都做上，任何环境都能跑。
5.3 JSP 页面中文全部变成乱码，数据库存进去的信息显示成问号
现象：日志正常，SQL 正常，但页面上的中文要么是“???”，要么是乱码字符。原因必然出在编码链路上，常见三处：JSP 的pageEncoding没写或不是 UTF-8；Tomcat 连接数据库时没有调用characterEncoding=utf8；web.xml 里缺少 CharacterEncodingFilter。三处只要断一环，中文就会翻车。
解决：先按顺序排查数据库连接 URL，jdbc:mysql://localhost:3306/edu_help?characterEncoding=utf8&useSSL=false；其次在 JSP 头部加contentType="text/html;charset=UTF-8"；最后补上 CharacterEncodingFilter 并映射到/*。这三步做完，绝大多数乱码问题都能解决。值得说明的是，URL 里的characterEncoding控制的是应用与数据库之间的传输编码，和浏览器渲染用的编码不是同一个概念，别混在一起。
5.4 JSTL 标签不生效，页面循环和 if 全部原样输出
现象：页面里<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>已经写了，JSP 也能编译，但<c:forEach>标签内容原样显示在浏览器上。原因：Maven 依赖虽配置了 jstl 1.2，但 IDEA 部署 war 包时没有把 jar 带进WEB-INF/lib，Tomcat 运行时根本找不到标签库实现，于是把标签当纯文本输出。
解决：在 Project Structure 的 Artifacts 页面里找到部署包，检查WEB-INF/lib下是否有 jstl-1.2.jar。没有就把依赖加入 artifact。更简单的方法是把 pom.xml 中 jstl 依赖的 scope 去掉默认 compile，然后强制重新构建。部署到外部 Tomcat 前也要看一下输出的 war 包里 lib 目录是否完整，这是传统 jsp 项目打包 war 的祖传问题。
5.5 本地能跑，部署到服务器或外部 Tomcat 后启动报 ClassNotFoundException
现象：IDEA 里一切正常，但把 war 包丢到不熟悉的 Tomcat 上启动，控制台出现ClassNotFoundException: com.mysql.jdbc.Driver或org.mybatis.spring.SqlSessionFactoryBean。原因：打的 war 包没有把 Maven 依赖的 jar 全部打进WEB-INF/lib，或者把多个 Tomcat 之间共享 jar 的路径搞混了。
解决：先用jar tf xxx.war | grep mysql检查 lib 目录内容。缺 jar 就回到 IDEA 清理并重新打包，重点看 Artifacts 的 “Include in project build” 是否勾选。另一个思路是把常用 jar 放到 Tomcat 的lib目录，比如 mysql 驱动，但如果项目本身也带同名不同版本驱动，就会造成版本冲突，解决办法是二选一，不要两边都放。这个查法能覆盖九成以上“本地正常、环境就挂”的问题。
6. 让毕设从“能跑”到“能答辩”：预警统计首页与一键导出帮扶记录
6.1 加一张按班级维度统计的预警柱状图
预警列表做出来后，导师最常问的第二个问题是“哪个班问题最严重”。我建议加一个统计接口：/warning/statistics，返回每个班级的预警人数和平均挂科门数。前端页面用 ECharts 画柱状图，后台只需要从 score 和 student 两张表按班级分组统计。这个功能本质上只是复用已有 SQL，但呈现效果完全不同，它把一个查询做成了“分析报表”，答辩时的价值感非常明显。
6.2 用 POI 导出帮扶记录 Excel，替代“打印页面”的原始演示
另一个加分项是导出功能。许多毕设做导出时直接在 JSP 页面上调浏览器的打印，虽然能用，但生成的文件不规范。换成 Apache POI 导出.xlsx表格也只需要几十行代码，核心思路是创建 Workbook，用 Sheet 和 Row 写入数据，最后写入HttpServletResponse的输出流。导出文件的响应头是关键，Content-Disposition里带attachment;filename=help_records.xlsx，浏览器才会弹出下载而不是直接打开乱码。
我改毕业设计时有个习惯：每次验收前，都把数据库删掉重建，从导入 SQL 开始完整跑一遍流程。这样能暴露出“配置只在我电脑里能跑”的隐患，也能让部署文档中的每一条命令都真实可复现。你要把自己的项目当成一本操作手册来整理，别人按步骤做完依然能通到同样的结果，这才配得上“源码含教程”这几个字。希望这一套设计思路和踩坑记录，能帮你少走几步弯路，把学业帮扶管理系统做成一个敢在答辩现场演示的完整作品。
本文还有配套的精品资源，点击获取
