尧图网站建设 
简介这是一套面向计算机相关专业学生与JavaWeb初学者整理的教务管理系统完整项目可直接用于高分毕业设计、课程设计或期末大作业。项目基于JavaWeb技术栈开发涵盖学生信息、课程安排、成绩录入与查询等教务核心业务模块代码结构清晰适合作为学习SSM/JSP开发与数据库设计的实战参考。压缩包共442个文件约4.25MB其中60个java源文件承载后端业务逻辑35个jsp页面负责视图展示62个js与21个css、16个less、14个scss共同完成前端交互与样式另有28个xml配置、2个properties及1个sql数据库脚本配合gif、png等静态素材构成一套可直接运行的工程。资源下载后无需修改即可运行数据库文件齐全省去自行建库建表的麻烦。目前已有424人学习下载适合需要快速获取完整项目、对照理解分层架构与前后端协作流程的读者参考使用。1. 从一份教务系统源码说起JavaWeb 项目到底该怎么跑起来很多计算机专业的同学拿到「基于 JavaWeb 的教务管理系统源码 数据库文件」这类毕业设计资源时第一反应是双击打开、点运行然后被一堆红色报错劝退。我当年也一样解压完看到几十个文件夹、几百个 Java 文件完全不知道从哪里下手。其实这类项目的结构是有套路的它本质上是一个标准的 JavaWeb 三层架构应用前端用 JSP 或 HTML 后端 Servlet/SSM 框架中间靠 Tomcat 跑底层连 MySQL。你只要把「环境 → 数据库 → 配置 → 启动」这条链路走通剩下的就是读代码改功能。这篇文章面向两类人一是拿到源码但跑不起来的同学二是想基于这套东西改出自己毕业设计的人。我会把教务管理系统从环境搭建、数据库导入、IDEA 配置、核心模块拆解到二次开发按我实际踩过的路讲一遍。不吹什么「一键运行」但跟着走你大概率能在半天内看到登录页面。2. 跑通教务系统的最小环境JDK、Tomcat、MySQL 三件套怎么配2.1 版本选型为什么 JDK 8 Tomcat 8.5 MySQL 5.7 是稳妥组合这类毕业设计项目大多写于 2019 到 2022 年之间用的技术栈以 SSMSpring SpringMVC MyBatis或原生 Servlet JSP 为主。这些框架对高版本 JDK 兼容性并不好尤其是 JDK 17 之后模块化改革导致反射受限很多老项目的ClassNotFoundException和InaccessibleObjectException就是这么来的。我一般推荐这套组合组件推荐版本原因JDK1.88u301 以上SSM 和 JSP 兼容性最好IDEA 支持成熟Tomcat8.5.xServlet 3.1 规范和大多数老项目 web.xml 匹配MySQL5.7.x驱动包 mysql-connector-java 5.1.x 默认适配Maven3.6.x依赖解析稳定不会因新版强制 HTTPS 拉包失败IDEA2021.3 或 2022.x对老项目导入友好新版有时索引异常如果你已经装了 JDK 11 或 17也不用卸载IDEA 里可以给单个项目指定 SDK。但 Tomcat 一定要用 8.5Tomcat 10 把javax.servlet改成了jakarta.servlet老项目直接全军覆没。安装完 JDK 后配置环境变量命令行验证java -version # 期望输出java version 1.8.0_301 javac -version # 期望输出javac 1.8.0_301MySQL 安装时记住 root 密码后面改配置文件要用。Tomcat 解压即用不需要装服务IDEA 里直接指向解压目录就行。提示不要用 MySQL 8.0 直接跑老项目。8.0 默认认证插件是caching_sha2_password而老驱动包只认mysql_native_password会报Unable to load authentication plugin。要么换 5.7要么手动改用户认证方式。2.2 数据库导入从 .sql 文件到可连接的表结构资源包里一般有个db或sql文件夹里面是.sql文件。导入方式有两种命令行和图形化工具。命令行方式# 登录 MySQL mysql -u root -p # 创建数据库字符集必须是 utf8mb4 CREATE DATABASE edu_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 切换到该数据库 USE edu_system; # 导入 sql 文件注意路径用绝对路径或当前目录 source D:/edu_project/db/edu_system.sql; # 验证表是否导入成功 SHOW TABLES;图形化工具Navicat、DBeaver更直观新建连接 → 新建数据库 → 右键「运行 SQL 文件」→ 选择.sql→ 执行。导入后重点检查三件事表数量对不对一般 10 到 20 张、字符集是不是 utf8mb4、有没有外键约束报错。如果导入时报Specified key was too long说明索引字段长度超了把VARCHAR(255)改成VARCHAR(191)再导。常见表结构大致是student学生、teacher教师、course课程、score成绩、class班级、user登录用户。搞清楚这几张表的关联关系后面改代码就不迷路。2.3 IDEA 导入项目从解压到识别 Web 模块打开 IDEA选择Open指向解压后的项目根目录。如果项目里有pom.xmlIDEA 会自动识别为 Maven 项目并开始下载依赖。没有pom.xml的说明是传统 Web 项目需要手动配置。Maven 项目导入后先检查pom.xml里的依赖有没有飘红。飘红通常是仓库地址失效或网络问题在settings.xml里换成阿里云镜像mirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror然后右键项目 →Maven→Reload project。非 Maven 项目要手动配 FacetsFile→Project Structure→Facets→ 添加Web指向web或WebContent目录然后在Artifacts里添加Web Application: Exploded把WEB-INF/lib下的 jar 包都加进去。这一步最容易翻车的地方是web.xml版本和 Servlet 版本对不上。如果web.xml头部的version4.0但 Tomcat 是 8.5只支持到 3.1启动会报解析错误。把 version 改成 3.1 即可。3. 配置数据源与 Tomcat让登录页面真正弹出来3.1 改数据库连接四个参数决定你能不能连上项目里数据库配置一般在这几个位置之一db.properties、jdbc.properties、applicationContext.xml、mybatis-config.xml。找到后改这四个参数jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/edu_system?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password你的密码参数说明driver老项目用com.mysql.jdbc.DriverMySQL 8 驱动用com.mysql.cj.jdbc.Driverurl里的useSSLfalse必须加否则会有安全警告甚至连接失败characterEncodingutf8防止中文乱码serverTimezoneAsia/Shanghai在 MySQL 8 下必须加5.7 可加可不加。如果配置文件里是硬编码在 Java 类里的比如DBUtil.java直接改对应字符串。改完在 IDEA 里搜一下password关键字确保没有遗漏。3.2 Tomcat 部署Artifact、Context Path 和端口三处必查Run→Edit Configurations→ 加号 →Tomcat Server→Local。Server标签页Application server指向 Tomcat 解压目录HTTP port默认 8080被占用就改 8081。Deployment标签页点加号 →Artifact→ 选xxx:war exploded。Application context建议改成/或/edu这就是你访问时的路径前缀。启动后控制台如果出现Server startup in xxx ms说明 Tomcat 起来了。浏览器访问http://localhost:8080/应该能看到登录页。如果报404检查 Context Path 和项目首页配置如果报500看控制台异常栈八成是数据库连不上或某个 Bean 没注入如果报ClassNotFoundException说明 jar 包没进WEB-INF/lib去Project Structure→Artifacts里补。3.3 登录流程走一遍验证环境是否真的通了默认账号密码一般在sql文件的user表里或者 README 里写着。常见的是admin/123456或admin/admin。登录时后端做的事前端表单 POST 到/login→ Controller 接收参数 → Service 调 Mapper 查user表 → 比对密码 → 写入 Session → 重定向到主页。如果登录后跳转空白页看 Session 有没有写进去如果提示密码错误但数据库里明明有检查密码是不是 MD5 加密存储的前端有没有做加密。很多项目密码存的是明文但代码里写了MD5Util.encrypt()这种不一致就是坑。注意跑通登录只是第一步。教务系统的核心在后面的学生管理、课程管理、成绩录入模块那些才是你改毕业设计时要动的地方。4. 教务系统核心模块拆解学生、课程、成绩三张表怎么联动4.1 学生管理模块CRUD 背后的分页与条件查询学生管理是最典型的 CRUD 模块。打开StudentController.java你会看到list、add、update、delete四个方法。真正值得研究的是list方法里的分页逻辑。常见实现是 PageHelper 插件// Controller 层 RequestMapping(/student/list) public String list(RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, String keyword, Model model) { PageHelper.startPage(pageNum, pageSize); ListStudent students studentService.findByKeyword(keyword); PageInfoStudent pageInfo new PageInfo(students); model.addAttribute(pageInfo, pageInfo); return student/list; }逻辑说明PageHelper.startPage必须紧挨着查询语句中间不能插别的数据库操作否则分页会作用到错误的 SQL 上。keyword是模糊查询条件Mapper XML 里用if testkeyword ! null动态拼接LIKE。参数说明pageNum当前页码pageSize每页条数PageInfo封装了总记录数、总页数、是否有上一页下一页。前端 JSP 里用c:forEach遍历pageInfo.list。改毕业设计时这个模块最容易加的功能是「按班级筛选」「导出 Excel」「批量删除」。批量删除就是把前端选中的 id 拼成数组传到后端Mapper 里用foreach拼IN条件。4.2 课程与成绩模块外键关联和事务处理课程表course和成绩表score通过course_id关联成绩表还关联student_id。录入成绩时后端要做两件事校验学生和课程是否存在、插入或更新成绩记录。Transactional public void saveScore(Score score) { // 先查是否已有记录有则更新无则插入 Score exist scoreMapper.findByStudentAndCourse(score.getStudentId(), score.getCourseId()); if (exist ! null) { score.setId(exist.getId()); scoreMapper.update(score); } else { scoreMapper.insert(score); } }Transactional保证两步操作的原子性。如果插入成功但更新失败事务回滚。这里常见的坑是自调用失效同一个类里 A 方法调 B 方法B 上的Transactional不生效因为没走代理。解决办法是把 B 方法抽到另一个 Service 里或者注入自己的代理。成绩模块的查询通常要联表SELECT s.name AS studentName, c.name AS courseName, sc.score FROM score sc JOIN student s ON sc.student_id s.id JOIN course c ON sc.course_id c.id WHERE sc.course_id #{courseId}这条 SQL 在 Mapper XML 里对应一个select返回类型用resultMap或Map。如果字段名和属性名不一致必须写resultMap否则查出来是 null。4.3 权限控制拦截器与 Session 校验教务系统一般有三种角色管理员、教师、学生。登录后根据角色跳不同主页访问受限页面时用拦截器校验 Session。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); User user (User) session.getAttribute(currentUser); if (user null) { response.sendRedirect(request.getContextPath() /login); return false; } return true; } }拦截器在spring-mvc.xml里注册配置mvc:interceptor和mvc:exclude-mapping排除登录、注册、静态资源路径。角色级别的权限控制简单做法是在拦截器里判断user.getRole()复杂做法用 Shiro 或 Spring Security。毕业设计用拦截器足够了别为了炫技引入安全框架配置量翻倍还容易出 bug。5. 避坑与排查跑教务系统源码时最容易翻车的 5 个地方5.1 中文乱码从数据库到 JSP 的全链路排查现象页面显示??????或教务数据库里存的中文也变成乱码。原因字符集在某一环断了。可能是数据库建库时没用 utf8mb4可能是 JDBC URL 没加characterEncodingutf8可能是 Tomcat 的server.xml里 Connector 没加URIEncodingUTF-8也可能是 JSP 页面没写% page contentTypetext/html;charsetUTF-8 %。解决按链路逐段查。数据库SHOW VARIABLES LIKE character%确认JDBC URL 补参数Tomcat Connector 加URIEncodingUTF-8JSP 头部加 page 指令如果是 POST 请求在web.xml里加CharacterEncodingFilter。5.2 依赖冲突NoSuchMethodError 和 ClassNotFoundException现象启动时报java.lang.NoSuchMethodError或java.lang.ClassNotFoundException指向某个 Spring 或 MyBatis 的类。原因Maven 传递依赖拉了两个版本的同一个 jar或者WEB-INF/lib下手动放的 jar 和 Maven 依赖版本不一致。解决IDEA 里用Maven→Dependency Analyzer看依赖树排除重复版本。命令行mvn dependency:tree也能看。如果是非 Maven 项目检查lib目录下有没有同名不同版本的 jar删掉旧的。5.3 数据库连接池报错Timeout 和 Too many connections现象启动正常访问几次后报Could not get JDBC Connection或Too many connections。原因连接池配置的maxActive太小或者代码里有连接没关闭导致泄漏。老项目用 DBCP 或 C3P0 居多配置在applicationContext.xml里。解决把maxActive调到 20 到 50maxWait调到 10000ms。同时检查 DAO 层有没有在 finally 里关闭Connection、Statement、ResultSet。用 MyBatis 的话SqlSession 由框架管理一般不会泄漏但手动写 JDBC 的地方要留意。5.4 静态资源 404CSS、JS、图片加载不出来现象页面能打开但样式全无F12 看 Network 全是 404。原因SpringMVC 的DispatcherServlet拦截了所有请求包括静态资源。需要在spring-mvc.xml里放行。解决加mvc:default-servlet-handler/或mvc:resources mapping/static/** location/static//。前者把静态资源交回给 Tomcat 默认 Servlet 处理后者显式映射路径。JSP 里引用路径用${pageContext.request.contextPath}/static/css/style.css不要用相对路径。5.5 修改代码后不生效缓存与热部署问题现象改了 Java 代码或 JSP重启 Tomcat 后还是旧逻辑。原因IDEA 的 Artifact 没重新编译或者 Tomcat 用了war包而不是war exploded或者浏览器缓存了旧 JSP。解决确认 Deployment 里用的是war exploded改完代码Build→Rebuild ProjectTomcat 配置里On Update action选Update classes and resources浏览器Ctrl F5强制刷新。JSP 改动一般不用重启Java 代码改动必须重启。6. 从能跑到能改二次开发与毕业设计答辩的加分技巧跑通只是起点毕业设计要拿高分得让老师看到你「改了什么、为什么改、效果如何」。我一般建议从三个方向入手。第一个方向是加功能。比如原系统只有管理员能录成绩你加一个「教师端成绩录入 学生端成绩查询」涉及角色权限、页面跳转、数据过滤工作量适中且容易演示。实现上就是在拦截器里加角色判断Controller 里根据 Session 里的角色返回不同视图。第二个方向是优化体验。原系统的分页可能是手写的LIMIT你换成 PageHelper 并加上「跳转到第几页」「每页显示条数切换」原系统的删除是物理删除你改成逻辑删除加is_deleted字段答辩时讲「数据可恢复」就是一个亮点。第三个方向是补文档和测试。用 Postman 把核心接口跑一遍截图放进论文用 JUnit 写几个 Service 层的单元测试证明你的改动没破坏原有逻辑。老师不一定看代码但一定看论文里的图表和测试结果。一个具体技巧答辩演示前把数据库里的测试数据准备好学生姓名用真实中文名课程名用「高等数学」「大学英语」这种别用test1、aaa。演示路径提前走三遍确保不会在老师面前翻车。我当年就是演示时数据库连不上因为答辩教室网络环境变了MySQL 的bind-address没配好。后来我养成的习惯是任何演示环境提前一天在目标机器上完整跑一遍把localhost改成127.0.0.1避免 DNS 解析问题数据库密码设成最简单的别在这种地方给自己挖坑。希望帮到你。本文还有配套的精品资源点击获取 JavaWeb教务系统源码跑通与二次开发实战指南
简介这是一套面向计算机相关专业学生与JavaWeb初学者整理的教务管理系统完整项目可直接用于高分毕业设计、课程设计或期末大作业。项目基于JavaWeb技术栈开发涵盖学生信息、课程安排、成绩录入与查询等教务核心业务模块代码结构清晰适合作为学习SSM/JSP开发与数据库设计的实战参考。压缩包共442个文件约4.25MB其中60个java源文件承载后端业务逻辑35个jsp页面负责视图展示62个js与21个css、16个less、14个scss共同完成前端交互与样式另有28个xml配置、2个properties及1个sql数据库脚本配合gif、png等静态素材构成一套可直接运行的工程。资源下载后无需修改即可运行数据库文件齐全省去自行建库建表的麻烦。目前已有424人学习下载适合需要快速获取完整项目、对照理解分层架构与前后端协作流程的读者参考使用。1. 从一份教务系统源码说起JavaWeb 项目到底该怎么跑起来很多计算机专业的同学拿到「基于 JavaWeb 的教务管理系统源码 数据库文件」这类毕业设计资源时第一反应是双击打开、点运行然后被一堆红色报错劝退。我当年也一样解压完看到几十个文件夹、几百个 Java 文件完全不知道从哪里下手。其实这类项目的结构是有套路的它本质上是一个标准的 JavaWeb 三层架构应用前端用 JSP 或 HTML 后端 Servlet/SSM 框架中间靠 Tomcat 跑底层连 MySQL。你只要把「环境 → 数据库 → 配置 → 启动」这条链路走通剩下的就是读代码改功能。这篇文章面向两类人一是拿到源码但跑不起来的同学二是想基于这套东西改出自己毕业设计的人。我会把教务管理系统从环境搭建、数据库导入、IDEA 配置、核心模块拆解到二次开发按我实际踩过的路讲一遍。不吹什么「一键运行」但跟着走你大概率能在半天内看到登录页面。2. 跑通教务系统的最小环境JDK、Tomcat、MySQL 三件套怎么配2.1 版本选型为什么 JDK 8 Tomcat 8.5 MySQL 5.7 是稳妥组合这类毕业设计项目大多写于 2019 到 2022 年之间用的技术栈以 SSMSpring SpringMVC MyBatis或原生 Servlet JSP 为主。这些框架对高版本 JDK 兼容性并不好尤其是 JDK 17 之后模块化改革导致反射受限很多老项目的ClassNotFoundException和InaccessibleObjectException就是这么来的。我一般推荐这套组合组件推荐版本原因JDK1.88u301 以上SSM 和 JSP 兼容性最好IDEA 支持成熟Tomcat8.5.xServlet 3.1 规范和大多数老项目 web.xml 匹配MySQL5.7.x驱动包 mysql-connector-java 5.1.x 默认适配Maven3.6.x依赖解析稳定不会因新版强制 HTTPS 拉包失败IDEA2021.3 或 2022.x对老项目导入友好新版有时索引异常如果你已经装了 JDK 11 或 17也不用卸载IDEA 里可以给单个项目指定 SDK。但 Tomcat 一定要用 8.5Tomcat 10 把javax.servlet改成了jakarta.servlet老项目直接全军覆没。安装完 JDK 后配置环境变量命令行验证java -version # 期望输出java version 1.8.0_301 javac -version # 期望输出javac 1.8.0_301MySQL 安装时记住 root 密码后面改配置文件要用。Tomcat 解压即用不需要装服务IDEA 里直接指向解压目录就行。提示不要用 MySQL 8.0 直接跑老项目。8.0 默认认证插件是caching_sha2_password而老驱动包只认mysql_native_password会报Unable to load authentication plugin。要么换 5.7要么手动改用户认证方式。2.2 数据库导入从 .sql 文件到可连接的表结构资源包里一般有个db或sql文件夹里面是.sql文件。导入方式有两种命令行和图形化工具。命令行方式# 登录 MySQL mysql -u root -p # 创建数据库字符集必须是 utf8mb4 CREATE DATABASE edu_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 切换到该数据库 USE edu_system; # 导入 sql 文件注意路径用绝对路径或当前目录 source D:/edu_project/db/edu_system.sql; # 验证表是否导入成功 SHOW TABLES;图形化工具Navicat、DBeaver更直观新建连接 → 新建数据库 → 右键「运行 SQL 文件」→ 选择.sql→ 执行。导入后重点检查三件事表数量对不对一般 10 到 20 张、字符集是不是 utf8mb4、有没有外键约束报错。如果导入时报Specified key was too long说明索引字段长度超了把VARCHAR(255)改成VARCHAR(191)再导。常见表结构大致是student学生、teacher教师、course课程、score成绩、class班级、user登录用户。搞清楚这几张表的关联关系后面改代码就不迷路。2.3 IDEA 导入项目从解压到识别 Web 模块打开 IDEA选择Open指向解压后的项目根目录。如果项目里有pom.xmlIDEA 会自动识别为 Maven 项目并开始下载依赖。没有pom.xml的说明是传统 Web 项目需要手动配置。Maven 项目导入后先检查pom.xml里的依赖有没有飘红。飘红通常是仓库地址失效或网络问题在settings.xml里换成阿里云镜像mirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror然后右键项目 →Maven→Reload project。非 Maven 项目要手动配 FacetsFile→Project Structure→Facets→ 添加Web指向web或WebContent目录然后在Artifacts里添加Web Application: Exploded把WEB-INF/lib下的 jar 包都加进去。这一步最容易翻车的地方是web.xml版本和 Servlet 版本对不上。如果web.xml头部的version4.0但 Tomcat 是 8.5只支持到 3.1启动会报解析错误。把 version 改成 3.1 即可。3. 配置数据源与 Tomcat让登录页面真正弹出来3.1 改数据库连接四个参数决定你能不能连上项目里数据库配置一般在这几个位置之一db.properties、jdbc.properties、applicationContext.xml、mybatis-config.xml。找到后改这四个参数jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/edu_system?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password你的密码参数说明driver老项目用com.mysql.jdbc.DriverMySQL 8 驱动用com.mysql.cj.jdbc.Driverurl里的useSSLfalse必须加否则会有安全警告甚至连接失败characterEncodingutf8防止中文乱码serverTimezoneAsia/Shanghai在 MySQL 8 下必须加5.7 可加可不加。如果配置文件里是硬编码在 Java 类里的比如DBUtil.java直接改对应字符串。改完在 IDEA 里搜一下password关键字确保没有遗漏。3.2 Tomcat 部署Artifact、Context Path 和端口三处必查Run→Edit Configurations→ 加号 →Tomcat Server→Local。Server标签页Application server指向 Tomcat 解压目录HTTP port默认 8080被占用就改 8081。Deployment标签页点加号 →Artifact→ 选xxx:war exploded。Application context建议改成/或/edu这就是你访问时的路径前缀。启动后控制台如果出现Server startup in xxx ms说明 Tomcat 起来了。浏览器访问http://localhost:8080/应该能看到登录页。如果报404检查 Context Path 和项目首页配置如果报500看控制台异常栈八成是数据库连不上或某个 Bean 没注入如果报ClassNotFoundException说明 jar 包没进WEB-INF/lib去Project Structure→Artifacts里补。3.3 登录流程走一遍验证环境是否真的通了默认账号密码一般在sql文件的user表里或者 README 里写着。常见的是admin/123456或admin/admin。登录时后端做的事前端表单 POST 到/login→ Controller 接收参数 → Service 调 Mapper 查user表 → 比对密码 → 写入 Session → 重定向到主页。如果登录后跳转空白页看 Session 有没有写进去如果提示密码错误但数据库里明明有检查密码是不是 MD5 加密存储的前端有没有做加密。很多项目密码存的是明文但代码里写了MD5Util.encrypt()这种不一致就是坑。注意跑通登录只是第一步。教务系统的核心在后面的学生管理、课程管理、成绩录入模块那些才是你改毕业设计时要动的地方。4. 教务系统核心模块拆解学生、课程、成绩三张表怎么联动4.1 学生管理模块CRUD 背后的分页与条件查询学生管理是最典型的 CRUD 模块。打开StudentController.java你会看到list、add、update、delete四个方法。真正值得研究的是list方法里的分页逻辑。常见实现是 PageHelper 插件// Controller 层 RequestMapping(/student/list) public String list(RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, String keyword, Model model) { PageHelper.startPage(pageNum, pageSize); ListStudent students studentService.findByKeyword(keyword); PageInfoStudent pageInfo new PageInfo(students); model.addAttribute(pageInfo, pageInfo); return student/list; }逻辑说明PageHelper.startPage必须紧挨着查询语句中间不能插别的数据库操作否则分页会作用到错误的 SQL 上。keyword是模糊查询条件Mapper XML 里用if testkeyword ! null动态拼接LIKE。参数说明pageNum当前页码pageSize每页条数PageInfo封装了总记录数、总页数、是否有上一页下一页。前端 JSP 里用c:forEach遍历pageInfo.list。改毕业设计时这个模块最容易加的功能是「按班级筛选」「导出 Excel」「批量删除」。批量删除就是把前端选中的 id 拼成数组传到后端Mapper 里用foreach拼IN条件。4.2 课程与成绩模块外键关联和事务处理课程表course和成绩表score通过course_id关联成绩表还关联student_id。录入成绩时后端要做两件事校验学生和课程是否存在、插入或更新成绩记录。Transactional public void saveScore(Score score) { // 先查是否已有记录有则更新无则插入 Score exist scoreMapper.findByStudentAndCourse(score.getStudentId(), score.getCourseId()); if (exist ! null) { score.setId(exist.getId()); scoreMapper.update(score); } else { scoreMapper.insert(score); } }Transactional保证两步操作的原子性。如果插入成功但更新失败事务回滚。这里常见的坑是自调用失效同一个类里 A 方法调 B 方法B 上的Transactional不生效因为没走代理。解决办法是把 B 方法抽到另一个 Service 里或者注入自己的代理。成绩模块的查询通常要联表SELECT s.name AS studentName, c.name AS courseName, sc.score FROM score sc JOIN student s ON sc.student_id s.id JOIN course c ON sc.course_id c.id WHERE sc.course_id #{courseId}这条 SQL 在 Mapper XML 里对应一个select返回类型用resultMap或Map。如果字段名和属性名不一致必须写resultMap否则查出来是 null。4.3 权限控制拦截器与 Session 校验教务系统一般有三种角色管理员、教师、学生。登录后根据角色跳不同主页访问受限页面时用拦截器校验 Session。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); User user (User) session.getAttribute(currentUser); if (user null) { response.sendRedirect(request.getContextPath() /login); return false; } return true; } }拦截器在spring-mvc.xml里注册配置mvc:interceptor和mvc:exclude-mapping排除登录、注册、静态资源路径。角色级别的权限控制简单做法是在拦截器里判断user.getRole()复杂做法用 Shiro 或 Spring Security。毕业设计用拦截器足够了别为了炫技引入安全框架配置量翻倍还容易出 bug。5. 避坑与排查跑教务系统源码时最容易翻车的 5 个地方5.1 中文乱码从数据库到 JSP 的全链路排查现象页面显示??????或教务数据库里存的中文也变成乱码。原因字符集在某一环断了。可能是数据库建库时没用 utf8mb4可能是 JDBC URL 没加characterEncodingutf8可能是 Tomcat 的server.xml里 Connector 没加URIEncodingUTF-8也可能是 JSP 页面没写% page contentTypetext/html;charsetUTF-8 %。解决按链路逐段查。数据库SHOW VARIABLES LIKE character%确认JDBC URL 补参数Tomcat Connector 加URIEncodingUTF-8JSP 头部加 page 指令如果是 POST 请求在web.xml里加CharacterEncodingFilter。5.2 依赖冲突NoSuchMethodError 和 ClassNotFoundException现象启动时报java.lang.NoSuchMethodError或java.lang.ClassNotFoundException指向某个 Spring 或 MyBatis 的类。原因Maven 传递依赖拉了两个版本的同一个 jar或者WEB-INF/lib下手动放的 jar 和 Maven 依赖版本不一致。解决IDEA 里用Maven→Dependency Analyzer看依赖树排除重复版本。命令行mvn dependency:tree也能看。如果是非 Maven 项目检查lib目录下有没有同名不同版本的 jar删掉旧的。5.3 数据库连接池报错Timeout 和 Too many connections现象启动正常访问几次后报Could not get JDBC Connection或Too many connections。原因连接池配置的maxActive太小或者代码里有连接没关闭导致泄漏。老项目用 DBCP 或 C3P0 居多配置在applicationContext.xml里。解决把maxActive调到 20 到 50maxWait调到 10000ms。同时检查 DAO 层有没有在 finally 里关闭Connection、Statement、ResultSet。用 MyBatis 的话SqlSession 由框架管理一般不会泄漏但手动写 JDBC 的地方要留意。5.4 静态资源 404CSS、JS、图片加载不出来现象页面能打开但样式全无F12 看 Network 全是 404。原因SpringMVC 的DispatcherServlet拦截了所有请求包括静态资源。需要在spring-mvc.xml里放行。解决加mvc:default-servlet-handler/或mvc:resources mapping/static/** location/static//。前者把静态资源交回给 Tomcat 默认 Servlet 处理后者显式映射路径。JSP 里引用路径用${pageContext.request.contextPath}/static/css/style.css不要用相对路径。5.5 修改代码后不生效缓存与热部署问题现象改了 Java 代码或 JSP重启 Tomcat 后还是旧逻辑。原因IDEA 的 Artifact 没重新编译或者 Tomcat 用了war包而不是war exploded或者浏览器缓存了旧 JSP。解决确认 Deployment 里用的是war exploded改完代码Build→Rebuild ProjectTomcat 配置里On Update action选Update classes and resources浏览器Ctrl F5强制刷新。JSP 改动一般不用重启Java 代码改动必须重启。6. 从能跑到能改二次开发与毕业设计答辩的加分技巧跑通只是起点毕业设计要拿高分得让老师看到你「改了什么、为什么改、效果如何」。我一般建议从三个方向入手。第一个方向是加功能。比如原系统只有管理员能录成绩你加一个「教师端成绩录入 学生端成绩查询」涉及角色权限、页面跳转、数据过滤工作量适中且容易演示。实现上就是在拦截器里加角色判断Controller 里根据 Session 里的角色返回不同视图。第二个方向是优化体验。原系统的分页可能是手写的LIMIT你换成 PageHelper 并加上「跳转到第几页」「每页显示条数切换」原系统的删除是物理删除你改成逻辑删除加is_deleted字段答辩时讲「数据可恢复」就是一个亮点。第三个方向是补文档和测试。用 Postman 把核心接口跑一遍截图放进论文用 JUnit 写几个 Service 层的单元测试证明你的改动没破坏原有逻辑。老师不一定看代码但一定看论文里的图表和测试结果。一个具体技巧答辩演示前把数据库里的测试数据准备好学生姓名用真实中文名课程名用「高等数学」「大学英语」这种别用test1、aaa。演示路径提前走三遍确保不会在老师面前翻车。我当年就是演示时数据库连不上因为答辩教室网络环境变了MySQL 的bind-address没配好。后来我养成的习惯是任何演示环境提前一天在目标机器上完整跑一遍把localhost改成127.0.0.1避免 DNS 解析问题数据库密码设成最简单的别在这种地方给自己挖坑。希望帮到你。本文还有配套的精品资源点击获取