Java毕设实战：SSM+JSP学业帮扶管理系统源码含避坑指南

简介：面向高校毕业设计的一套 Java 学业帮扶管理系统项目包，后台采用 SSM 框架，页面使用 JSP，搭配 MySQL 数据库与 JDK 1.8，可在 Eclipse、MyEclipse、STS、IDEA 等开发工具中直接导入运行。压缩包共 845 个文件，大小约 23.38MB，以 JS、CSS、JSP 前端资源、Java 后台源码和 SQL 数据库脚本为主，另含图片、字体、图标等页面素材，结构清晰便于复用与二次开发。功能模块包含个人中心、家长管理、学生管理、教师管理、成绩信息管理、成绩预警管理、会议信息管理等，可以支撑完整的学生学业帮扶业务闭环。除源码和数据库脚本外，还附带环境工具包及同框架项目的安装教程，说明文档中给出了从环境配置到项目部署的指引，适合毕业设计选题参考或 SSM+JSP 入门实践。目前已有 90 人学习下载。

1. 毕业设计选它值不值：先看清学业帮扶管理系统到底在做什么

大学里挂科预警、学业困难帮扶、补考辅导跟进，这些工作过去靠辅导员手动维护 Excel 表格推进，一到期末就手忙脚乱。毕业设计 java 学业帮扶管理系统 ssmjspweb 源码含教程，本质是把「谁需要帮扶、谁在帮扶、帮到哪一步、帮扶有没有效果」这条完整业务线搬到 Web 端：管理员维护学生档案和预警名单，教师制定帮扶计划，学生提交帮扶记录，系统自动汇总帮扶进度。它看起来是一个标准管理系统，但嵌入了学业预警和帮扶闭环两个业务差异点，比纯 CRUD 题目在答辩时更有东西可讲。

技术选型上用 SSM（Spring + Spring MVC + MyBatis）+ JSP + MySQL，是学业帮扶这类管理系统最常见的落地组合。它比 Spring Boot 多暴露了一层配置和容器细节，而这些细节恰恰是答辩时导师最爱追问的地方，你讲得清楚，项目的说服力就上来了。这套方案适合三类人：课程里学过 SSM 但没完整做过项目的人、想做管理系统类题目又不想在框架上冒险的人、以及需要快速跑通再留时间打磨业务细节的人。

2. SSM+JSP 架构拆解：为什么这套组合仍是毕业设计的安全牌

2.1 一条请求从浏览器到数据库的完整链路

先把链路讲清楚，后面写代码才不会迷路。用户在 JSP 页面点「提交帮扶记录」按钮，浏览器发出 POST 请求，请求先到 web.xml 里配置的 DispatcherServlet。DispatcherServlet 根据 @RequestMapping 找到对应 Controller 方法，Controller 调 Service 接口，Service 实现类里写业务规则并调 Mapper 接口，Mapper 接口对应的 XML 文件里是真正的 SQL，MyBatis 把结果集映射成 Java 对象，再一路返回。Controller 把数据放进 ModelAndView 转发到 JSP，JSP 通过 EL 表达式和 JSTL 标签把数据渲染成 HTML 响应给浏览器。

这一段链路里，Spring 管对象生命周期和事务，Spring MVC 管请求路由和参数绑定，MyBatis 管 JDBC 和结果映射，三者边界很清楚。这也是毕业设计愿意选 SSM 而不是直接上 Spring Boot 的原因：Spring Boot 把自动配置都藏起来了，你写代码确实爽，但导师问一句「DispatcherServlet 是怎么被注册的」，没有 SSM 底子的人当场卡住。SSM 项目里你能讲清楚 web.xml、applicationContext.xml、spring-mvc.xml 三份配置各自的作用，这本身就是答辩得分点。

2.2 先搭骨架：pom.xml 依赖与 web.xml 配置

动手第一步不是写业务代码，而是把 SSM Web 项目的骨架搭对。我用 Maven 管依赖，Java 版本选 1.8，这是 SSM 时代最兼容的组合。pom.xml 里核心依赖有六组：spring-webmvc 负责 MVC 层，spring-jdbc 和 spring-tx 负责数据源和事务，mybatis 和 mybatis-spring 负责持久层集成，jstl 是 JSP 页面的标签库，mysql-connector-java 负责数据库驱动。

<properties> <spring.version>5.3.9</spring.version> <mybatis.version>3.5.9</mybatis.version> </properties> <dependencies> <!-- Spring MVC 与核心容器，必须放第一个 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <!-- JDBC 与事务管理，Service 层 @Transactional 靠它 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>${spring.version}</version> </dependency> <!-- MyBatis 核心，负责 SQL 映射 --> <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.7</version> </dependency> <!-- MySQL 驱动，8.x 与 5.x 的驱动类名不同，注意匹配 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.28</version> </dependency> <!-- JSTL，JSP 页面里做循环和判断要用 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> </dependencies>

版本上我习惯用 Spring 5.3.x 配 MyBatis 3.5.x，兼容性经过大量项目验证，没必要追新。mybatis-spring 这个桥接包最容易忽略，少了它 Spring 容器里根本创建不出 Mapper 的代理对象；另一个容易踩的是如果在 Tomcat 8 以下跑，servlet-api 需要以 provided 作用域单独引入，否则容器自带的 Servlet 类和项目里的冲突，容器起不来。

web.xml 是 SSM 项目的入口，所有请求要经过 DispatcherServlet，同时要配一个 CharacterEncodingFilter 解决中文乱码，这个过滤器必须在所有过滤器的最前面。

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" version="3.1"> <!-- 乱码过滤器，必须放在最前面，解决 POST 请求中文乱码 --> <filter> <filter-name>encoding</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> <init-param> <param-name>forceEncoding</param-name> <param-value>true</param-value> </init-param> </filter> <filter-mapping> <filter-name>encoding</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!-- 前端控制器，所有 .do 或 / 请求都交给 Spring MVC --> <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>

url-pattern 用/还是*.do是个取舍。用/会覆盖容器默认的静态资源处理器，需要额外加 mvc:resources 配置；用*.do不会拦截 JSP 和图片，但所有请求 URL 都得带.do后缀。我做学业帮扶系统习惯用/配 mvc:resources，因为 REST 风格的 URL 在答辩时更好看。load-on-startup 必须写 1，否则容器不会在启动时初始化 Spring 容器，第一次请求会非常慢。

项目目录按 controller / service / mapper / entity / interceptor / common 分包，JSP 页面单独放在 webapp/WEB-INF/views 下。为什么要放 WEB-INF 底下？因为浏览器不能直接访问 WEB-INF 里的资源，页面只能通过 Controller 转发进入，相当于强制所有页面访问都要经过 Controller，既好做权限控制，又避免有人绕过登录直接打开 JSP。这个细节被导师问到的概率很高。

2.3 Service 层为什么不能省：事务和业务规则的落点

很多第一次做 SSM 项目的同学喜欢在 Controller 里直接调 Mapper，省掉 Service 层，代码确实少写几行，但业务一复杂就翻车。学业帮扶系统里有一个必须依赖 Service 层才能保证正确性的场景：创建帮扶计划时，要同时插入 help_plan 表、把对应学生表的帮扶状态改成「帮扶中」、给帮扶人插入一条待办记录，三个操作必须在一个事务里完成。如果 Controller 直接调 Mapper，事务要么不生效，要么拆散在多个地方，一旦中间某条 SQL 失败，数据就处于半完成状态，后面统计全部对不上。

Service 层的正确用法是只写业务规则和事务边界，不碰 SQL。定义一个 HelpPlanService 接口，实现类里用 @Transactional 标注事务方法，内部依次调用 Mapper 接口。Controller 只负责收参数、调 Service、返回视图，不写任何业务逻辑。这个分层是 Java Web 课程反复强调的经典三层结构，也是答辩时最能体现工程意识的地方，后面第四章的核心代码会严格按这个分层展开。

3. 数据库设计先行：学业帮扶场景下的表结构与核心字段

3.1 从业务反推数据模型：帮扶闭环必须有哪几张表

数据库设计决定项目上限，业务没想清楚建表一定返工。学业帮扶系统的核心业务链是「预警 → 计划 → 执行 → 反馈」，至少需要四张表来支撑：用户表 user 承担登录和角色识别，学生信息表 student_profile 存学号、班级、学业数据，帮扶计划表 help_plan 记录谁帮扶谁、帮扶什么科目、目标是什么，帮扶记录表 help_record 存每一次帮扶的具体内容和反馈。有同学会问为什么 user 和 student_profile 要分开——因为一个用户可能是老师也可能是管理员，而 student_profile 只有学生有，拆开避免大量冗余字段为空。

帮扶计划表是业务关键。它至少要包含被帮扶学生 ID、帮扶人 ID、帮扶科目、计划开始和结束时间、帮扶目标、当前状态这几个字段。状态字段我建议用 int 而不是 varchar：0 表示待开始，1 表示帮扶中，2 表示已完成，3 表示已中止。用数字的好处是写业务统计 SQL 时可以直接 sum 和 group by，效率比字符串判断高，也方便前端下拉框做映射。帮扶记录表则要关联计划 ID，每次帮扶产生一条记录，内容包括帮扶日期、帮扶形式（线上答疑/线下辅导）、具体内容、学生反馈、下次计划，形成可追溯的完整闭环。

3.2 建表 SQL 与字段口径：user、student_profile、help_plan、help_record

直接给一份适合学业帮扶系统的建表 SQL，表名和字段名都用下划线风格，这是 MySQL 约定俗成的写法，配合 MyBatis 的驼峰映射设置可以免去大量 resultMap 手写工作。

-- 用户表：管理员、教师、学生三类角色共用一张表 CREATE TABLE `user` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `username` VARCHAR(50) NOT NULL UNIQUE COMMENT '登录名', `password` VARCHAR(100) NOT NULL COMMENT '密码，建议MD5加密后存储', `real_name` VARCHAR(50) NOT NULL COMMENT '真实姓名', `role` TINYINT NOT NULL DEFAULT 2 COMMENT '0管理员 1教师 2学生', `phone` VARCHAR(20) DEFAULT NULL COMMENT '联系电话', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY `uk_username` (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表'; -- 学生扩展信息表：只有 role=2 的用户才关联 CREATE TABLE `student_profile` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `user_id` INT NOT NULL COMMENT '关联user.id', `student_no` VARCHAR(20) NOT NULL COMMENT '学号', `class_name` VARCHAR(50) NOT NULL COMMENT '行政班级', `major` VARCHAR(50) COMMENT '专业', `warning_flag` TINYINT DEFAULT 0 COMMENT '学业预警标记 0无 1预警', `gpa` DECIMAL(3,1) DEFAULT 0.0 COMMENT '当前平均绩点', UNIQUE KEY `uk_user_id` (`user_id`), UNIQUE KEY `uk_student_no` (`student_no`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='学生扩展信息表'; -- 帮扶计划表：帮扶业务的核心表 CREATE TABLE `help_plan` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `student_id` INT NOT NULL COMMENT '被帮扶学生用户ID', `teacher_id` INT NOT NULL COMMENT '帮扶教师/学长用户ID', `course_name` VARCHAR(50) NOT NULL COMMENT '帮扶科目', `start_date` DATE NOT NULL COMMENT '计划开始日期', `end_date` DATE NOT NULL COMMENT '计划结束日期', `goal` VARCHAR(200) COMMENT '帮扶目标，如提高到70分', `status` TINYINT NOT NULL DEFAULT 0 COMMENT '0待开始 1帮扶中 2已完成 3已中止', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP, `update_time` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, KEY `idx_student_status` (`student_id`, `status`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='帮扶计划表'; -- 帮扶记录表：每次帮扶动作写入一条记录 CREATE TABLE `help_record` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `plan_id` INT NOT NULL COMMENT '关联help_plan.id', `record_date` DATETIME NOT NULL COMMENT '帮扶发生时间', `content` TEXT NOT NULL COMMENT '帮扶内容描述', `feedback` VARCHAR(200) COMMENT '学生反馈', `next_plan` VARCHAR(200) COMMENT '下次帮扶计划', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP, KEY `idx_plan_id` (`plan_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='帮扶记录表';

四张表的关联关系一句话讲明白：user 表是登录主体，student_profile 通过 user_id 一对一补全学生信息；help_plan 通过 student_id 和 teacher_id 关联两个 user 记录，代表一段帮扶关系；help_record 通过 plan_id 关联到计划。设计上每张表只存自己该管的数据，student_profile 里不放帮扶计划，help_plan 里不放每次帮扶的内容，这样统计和扩展都不会互相干扰。

参数说明：id 统一用 int 自增主键，学业帮扶系统数据量不大，不需要分布式 ID；password 字段长度给 100 是因为 MD5 的 32 位字符加密后仍要留扩展余量；时间字段用 DATETIME 而不用 TIMESTAMP，因为 DATETIME 范围更大，也不会受到 2038 年问题影响。表引擎选 InnoDB，外键不物理创建，保持逻辑外键，这样插入性能好，也避免毕业设计答辩时被问到「外键为什么不用」时答不上来。

3.3 三个容易被问住的边界设计：状态流转、冗余字段、软删除

数据库设计里最容易被导师追问的就是边界情况。第一个是帮扶计划的状态流转。状态字段我设计成 0 到 3 四个值，但要注意流转方向不是随便变的：只有 status=0 的计划可以改成 1，只有 status=1 的计划可以改成 2 或 3。这个约束光靠前端按钮控制不够，Service 层要写校验逻辑，比如「中止的计划不能重新开始」「已完成的计划不能重复提交帮扶记录」。答辩时主动讲出这条约束，导师会觉得你考虑过业务规则。

第二个是冗余字段的取舍。student_profile 里冗余了 user 表的 real_name、student_no 等字段，本质上违反了第三范式，但这是刻意的：因为学生名单查询和帮扶计划展示都是高频操作，每次 JOIN user 表虽然也能查出姓名，但 SQL 复杂度上来了，页面响应也慢。毕业设计规模下冗余一个姓名字段，性价比很高，但要能说出这个理由，不是无意中设计的。

第三个是软删除。帮扶计划涉及学生成绩和帮扶记录，物理删除会影响历史数据完整性和统计报表，所以删除操作我建议用 status 字段加一个「已删除」值，或者增加 is_deleted 字段。前端列表查询默认过滤掉已删除记录，但管理员后台还能看到完整历史。这个做法在答辩时讲出来是加分项，因为说明你考虑到了数据生命周期管理，而不是只会 delete from where。

4. 核心功能实现：从登录鉴权到帮扶闭环的关键代码

4.1 登录与角色路由：拦截器按角色区分页面权限

登录是所有业务的前置条件，但很多毕业设计只做了「登录后跳首页」，没有做角色权限控制，导致学生可以直接访问教师管理页面。学业帮扶系统一定要有按角色拦截的机制。我通常用一个登录拦截器加角色判断，拦截器在 Spring MVC 里的实现方式是继承 HandlerInterceptor 接口，在 preHandle 方法里判断 session 中是否有登录用户。

public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行登录接口和静态资源 String uri = request.getRequestURI(); if (uri.contains("/login") || uri.startsWith("/static/")) { return true; } // 从 session 取登录用户，没取到就重定向到登录页 User loginUser = (User) request.getSession().getAttribute("loginUser"); if (loginUser == null) { response.sendRedirect(request.getContextPath() + "/login"); return false; } // 角色判断：教师访问 /student/ 开头的路径时需要管理员权限 if (uri.startsWith("/admin/") && loginUser.getRole() != 0) { response.setStatus(403); request.getRequestDispatcher("/WEB-INF/views/common/403.jsp").forward(request, response); return false; } return true; } }

这段代码要配合 spring-mvc.xml 里的拦截器注册，指定要拦截哪些 URL 模式。我一般配置成拦截所有请求但放行静态资源路径。登录接口本身必须放行，否则用户永远无法登录，这是新手最容易犯的错。

参数说明：uri.startsWith("/static/") 是放行 CSS、JS、图片等静态资源，如果没配这一段，页面打开后所有样式全部丢失；session 里存的对象名要和登录方法里设置的一致，我见过因为 loginUser 和 login_user 两个命名不一致导致登录后立刻被踢回登录页的案例。403 JSP 页面在 WEB-INF 下，浏览器无法直接访问，只能通过内部转发，这也是前面把页面放 WEB-INF 的好处之一。

4.2 帮扶计划的创建与指派：三层代码一次写到位

创建帮扶计划是核心功能里最典型的三层交互，我把完整的 Controller 和 Service 关键代码写出来。Controller 接收页面提交的表单数据，Service 负责插入计划、更新学生状态、生成待办的三个动作，整个方法在一个事务中。

@Controller @RequestMapping("/plan") public class HelpPlanController { @Autowired private HelpPlanService helpPlanService; /** * 新增帮扶计划 */ @PostMapping("/create") public String createPlan(HelpPlan helpPlan, HttpSession session) { // 当前登录人作为计划创建者 User loginUser = (User) session.getAttribute("loginUser"); helpPlan.setStatus(0); helpPlanService.createHelpPlan(helpPlan, loginUser.getId()); return "redirect:/plan/list"; } }

Controller 非常薄，真正的逻辑在 Service 里。这里注意 @PostMapping 是 Spring 5 的写法，如果用的是 Spring 4 则要写成 @RequestMapping(value = "/create", method = POST)。

@Service public class HelpPlanServiceImpl implements HelpPlanService { @Autowired private HelpPlanMapper helpPlanMapper; @Autowired private StudentProfileMapper studentProfileMapper; @Override @Transactional(rollbackFor = Exception.class) public void createHelpPlan(HelpPlan helpPlan, Integer creatorId) { // 1. 插入帮扶计划主记录 helpPlan.setCreateBy(creatorId); helpPlanMapper.insert(helpPlan); // 2. 将被帮扶学生的预警状态清除，标记为已安排帮扶 StudentProfile profile = studentProfileMapper.selectByUserId(helpPlan.getStudentId()); profile.setWarningFlag(0); studentProfileMapper.updateWarningFlag(profile); } }

@Transactional(rollbackFor = Exception.class) 是必须写的，Spring 默认只对 RuntimeException 回滚，检查异常不会触发回滚。如果你在业务代码里捕获了异常但没有向上抛，事务会被吞掉，表面上看起来执行成功了，实际数据没有写入，这是高端翻车现场。选择 rollbackFor = Exception.class 覆盖所有异常类型是最稳妥的做法。

参数说明：helpPlanMapper.insert 对应的 XML 文件里要写 insert into help_plan，MyBatis 默认不会自动生成主键，需要 useGeneratedKeys="true" keyProperty="id" 配置才能拿到回填的自增 ID，这个参数特别关键——本案例中创建后要立刻用到新计划 ID 的场景很常见。studentProfileMapper 更新的是学生预警状态，这一步是为了满足「帮扶计划创建后，学生不应该继续处于黄色预警列表里」的业务规则，这就是 Service 层存在的原因：它把两个 Mapper 操作绑定在了一个事务里。

4.3 帮扶记录的进度统计：给 JSP 页面喂数据

最后把 JSP 页面渲染这段补上。帮扶记录列表页属于低频编辑、高频查询的场景，我用 MyBatis 的关联查询一次性查出记录和对应的计划、学生姓名，减少页面上的多次 Ajax 请求。真实业务里一定要求按创建时间倒序，满足「最近帮扶完的记录排在最上面」的使用直觉。

<select id="selectRecordWithPlan" resultMap="recordWithPlanMap"> SELECT r.id, r.plan_id, r.record_date, r.content, r.feedback, p.course_name, p.student_id, u.real_name AS student_name FROM help_record r JOIN help_plan p ON r.plan_id = p.id JOIN user u ON p.student_id = u.id ORDER BY r.record_date DESC </select>

resultMap 里要定义好字段映射，尤其是别名 student_name 要映射到实体的 studentName 属性。SQL 里三个表 JOIN，但只查必用的字段，不要 select *，因为帮扶记录表有 TEXT 类型的 content 字段，全表扫描时拖慢查询。JOIN 顺序上以小表 help_record 为主表，然后关联 help_plan，再关联 user 表，MySQL 优化器通常会自己调整，但写 SQL 时保持这个顺序可读性最好。

JSP 页面渲染部分，用 JSTL 的 c:forEach 循环输出记录列表。要注意 JSP 页面文件头必须引入 taglib 标签库声明，否则 c:forEach 不识别。

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> <table class="table table-bordered"> <thead> <tr> <th>学生姓名</th> <th>帮扶科目</th> <th>帮扶日期</th> <th>帮扶内容</th> <th>学生反馈</th> </tr> </thead> <tbody> <c:forEach items="${recordList}" var="rec"> <tr> <td>${rec.studentName}</td> <td>${rec.courseName}</td> <td><fmt:formatDate value="${rec.recordDate}" pattern="yyyy-MM-dd HH:mm"/></td> <td>${rec.content}</td> <td>${rec.feedback}</td> </tr> </c:forEach> </tbody> </table>

Controller 里返回 ModelAndView 时要把 recordList 这个键名和 JSP 里的 items 值保持一致，这又是一处高频失误点。fmt:formatDate 用来格式化日期，如果你导入的是 java.util.Date 类型，直接用即可；如果你不小心导成了 java.sql.Timestamp，也要先转成 Date 才能格式化，否则页面会直接报错。我之前在这个问题上翻过车：数据显示成Thu Apr 11 2024 14:30:00 GMT+0800，就是因为没加 fmt 格式化。

5. SSM+JSP 项目避坑指南：5 个让我返工一整天的经典坑

5.1 现象：JSP 页面上 EL 表达式原样输出，${user.name} 直接显示在页面上

原因：web.xml 里的 web-app 版本号低于 2.5 时，Servlet 容器默认不启用 EL 表达式；另一种可能是页面顶部漏了 isELIgnored 配置，或者 JSP 里引用了不存在的属性名，导致 EL 求值失败后原样输出。

解决：把 web.xml 的根元素版本改成 3.1 以上，并在 JSP 页面顶部加<%@ page isELIgnored="false" %>强制开启 EL。同时检查向页面放数据的键名是不是真的叫 user，用浏览器开发者工具看 Network 响应体和 IDEA 的控制台日志，对比 Controller 里 model.addAttribute 的键名，很多时候只是拼写不一致。

5.2 现象：MyBatis 查询结果全是 null，但直接在 MySQL 里执行同一句 SQL 能查出数据

原因：实体类属性用的是驼峰命名，比如 studentName，而数据库字段是下划线 student_no，MyBatis 默认不开启驼峰自动映射，导致字段对不上，属性全没值。

解决：在 mybatis-config.xml 里加<setting name="mapUnderscoreToCamelCase" value="true"/>，打开下划线转驼峰映射。如果个别字段名对不上，再在 resultMap 里手动指定 column 和 property。这个配置是配置文件里最省事的一行，效果却立竿见影，写项目前先配好，能省一整天查错时间。

5.3 现象：页面访问 404，Controller 里明明写了 @RequestMapping

原因：DispatcherServlet 的 url-pattern 配的是*.do，而页面请求路径没有带 .do 后缀。或者 spring-mvc.xml 里配置了<context:component-scan base-package="com.xxx.controller"/>的包名写错，Controller 没有被扫描进 Spring 容器，自然不会有映射。

解决：先打开 IDEA 的控制台看启动日志，有没有打印出RequestMappingHandlerMapping的映射信息。如果日志里出现了/plan/create之类的映射，说明 Controller 已注册，问题在 url-pattern；如果日志里没有，检查包名和注解。我把排查顺序固定成「先看容器有没有注册 → 再看请求路径后缀 → 最后看 web.xml 映射」，这套思路能覆盖绝大多数 404 场景。

5.4 现象：@Transactional 不生效，事务里的多表操作只成功了前半部分

原因：最常见的两个原因，一是拦截器没有配置到 spring 配置里，事务代理没有生成；二是方法被同类内部调用，比如 Service 类里方法 A 调方法 B，B 上有 @Transactional，但 A 没有，Spring 的代理机制不拦截内部自调用，事务就没生效。

解决：事务注解只加在 Controller 调用的那一个 Service 入口方法上，不要分散标注。内部方法如果确实需要独立事务，就把它们拆到另一个 Service 类里，通过注入调用。另外检查 spring 配置里确实配置了<tx:annotation-driven transaction-manager="transactionManager"/>，这一行漏掉，所有事务注解全部白写。

5.5 现象：中文乱码，页面显示问号或乱码字符，数据库里存的也是乱码

原因：链条上的编码不一致：JSP 页面编码不是 UTF-8、Tomcat 接收请求的编码格式不是 UTF-8、MySQL 建表时字符集用了 latin1、JDBC 连接串没加 characterEncoding=UTF-8。四环里任何一环断掉都会乱码。

解决：统一全链路 UTF-8。JSP 页面头声明pageEncoding="UTF-8"，web.xml 里加 CharacterEncodingFilter，JDBC 连接串后追加?useUnicode=true&characterEncoding=UTF-8，MySQL 建表时显式指定 charset=utf8mb4。日常排查时先用数据库客户端直接看表数据，如果库里已经是乱码，说明写入时编码就不对；如果库里正常而 JSP 页面乱码，问题出在页面编码或响应头，用 F12 看响应头里的 Content-Type 里有没有 charset=UTF-8，没有就是 Spring 配置里的消息转换器没设对。乱码问题是玄学外衣下的工程问题，链路全部统一编码就永远不出现。

6. 答辩与验证：给系统加分的三个验证维度和一个优化建议

系统能跑通只是及格线，答辩前花半天做一次系统性验证，往往比你多写一个功能模块更值得。第一个验证维度是核心业务链路：从管理员创建预警学生名单开始，到教师创建帮扶计划，到学生提交帮扶记录，再到管理员查看帮扶进度统计，整条链路用真实数据走一遍，截图留档。第二步验证角色权限：分别用管理员、教师、学生三个账号登录，确认低权限用户访问高权限页面时被拦截器挡住，而不是直接看到功能菜单。第三个维度是数据一致性：创建计划后直接查看数据库，确认 help_plan、student_profile 两条记录的状态都同步变化，这也验证了事务是否真正生效。

优化建议我强烈推荐加一个「帮扶进度看板」页面，用简单的 SQL 按计划状态统计数量，展示待开始、帮扶中、已完成、已中止四个数字卡片，不需要引入任何图表库，纯 HTML 加四个 div 就能实现。这个功能数据库查询极简单，但业务价值很高——管理者一打开首页就能看到全院的帮扶覆盖情况，答辩时把这个页面讲成「数据可视化辅助决策」，比多做一个毫无亮点的 CRUD 模块有说服力得多。

做这个题目最大的教训是：永远不要在答辩前一夜才第一次启动完整流程。SSM 项目配置环节多，环境差异大，今天能跑不代表明天换台机器还能跑。我习惯把启动前置条件写成一个 README，包括 JDK 版本、MySQL 版本、数据库脚本导入顺序、Tomcat 启动参数，这样到了演示环境五分钟就能把项目跑起来，而不是在导师面前现场翻车。希望这个方向的拆解能帮到你，把它做完并讲清楚，你收获的不仅是一个毕设分数，而是一条完整的管理系统落地经验。

本文还有配套的精品资源，点击获取