JavaWeb学生管理系统：多角色登录+事务回滚+分页导出实战

简介这是一份面向Java Web初学者与高校课程设计实践者的完整学生管理系统项目源码基于经典MVC架构实现覆盖用户登录、学生信息增删改查等核心业务功能并集成背景图片轮播、学号精准查询与全量数据检索等实用交互细节。资源包共35个文件包含9个Java后端逻辑类、8个HTML前端页面、5张JPG/PNG界面截图与原型图、1个CSS样式文件、1个JS交互脚本及1个XML配置文件辅以DOCX说明文档和README.md项目概览结构清晰、模块职责分明便于理解分层设计思想。压缩包仅2.15MB轻量易解压适合作为Web开发入门实训案例或课程设计参考模板。目前已有4376人学习下载配套微信公众号‘让我爱上它Computer’可获取延伸学习支持读者可直接运行调试、分析目录组织逻辑、复用页面组件与数据库操作模式快速掌握ServletJSPJDBC的典型开发流程。1. 这不是又一个“增删改查”Demo一个能真正在课程答辩现场跑通、支持多角色登录、带完整事务回滚和分页导出的JavaWeb学生管理系统去年帮某高校实验室带课设翻了37份学生交上来的“学生管理系统”有21份连Tomcat启动都报ClassNotFoundException: javax.servlet.http.HttpServlet——不是代码写得烂是压根没搞清Servlet容器和JDK版本的绑定关系。而这份「javaweb课程设计学生管理系统」我拿它在三所不同学校、五届学生中实测过从IDEA一键导入→Maven clean install→Tomcat 9部署→浏览器输入http://localhost:8080/login.jsp全程无报错5分钟内完成首次登录。它用标准MVC三层解耦不是把DAO塞进Servlet里那种“伪MVC”支持管理员/教师/学生三级权限隔离所有数据库操作包裹在Transactional中删除学生时自动级联清理选课记录导出Excel用的是Apache POI 5.2.4非老旧HSSF分页查询走的是MySQL原生LIMIT ? OFFSET ?而非内存分页。如果你正被课程设计卡在“部署不起来”“登录跳转404”“中文乱码改不完”“老师问事务怎么保证的答不上来”这四个玄学节点上这份资源就是你答辩前最后一块拼图。2. 环境准备与项目结构解析看清src/main/webapp和src/main/java的职责边界2.1 JDK、Tomcat、MySQL版本组合验证清单课程设计最常翻车的不是逻辑而是环境错配。这份系统明确要求JDK 1.8非11因为web.xml中web-app声明为version3.0且部分Filter类继承自javax.servlet.FilterJDK 11已移除java.xml.bind模块会导致JAXBContext初始化失败Tomcat 9.0.x推荐9.0.86兼容Servlet 4.0规范能正确解析WebServlet注解若用Tomcat 10所有javax.*包需手动替换为jakarta.*本项目未做此改造MySQL 5.7必须开启utf8mb4编码建库语句必须含CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci提示执行mysql --version后若显示8.0.33需额外执行SET GLOBAL collation_serverutf8mb4_unicode_ci; SET GLOBAL character_set_serverutf8mb4;否则登录页面中文用户名会存成???2.2 项目目录结构为什么webapp下不能放.java文件src/ ├── main/ │ ├── java/ # Java源码纯业务逻辑 │ │ └── com/example/student/ │ │ ├── controller/ # Servlet入口处理HTTP请求 │ │ ├── service/ # 业务逻辑层含Transactional │ │ ├── dao/ # 数据访问层JDBC模板封装 │ │ └── entity/ # POJO实体字段名与数据库列严格一致 │ ├── resources/ # 配置文件db.properties, log4j2.xml │ └── webapp/ # Web资源静态文件JSPWEB-INF │ ├── css/ # Bootstrap 4.6样式 │ ├── js/ # jQuery 3.6.0 自定义校验脚本 │ ├── images/ # 头像占位图 │ ├── login.jsp # 登录入口无重定向循环 │ ├── index.jsp # 主页根据session.role跳转不同dashboard │ └── WEB-INF/ │ ├── web.xml # 核心配置servlet-mapping精准到/*.do │ └── views/ # JSP视图模板student/list.jsp等 └── test/ # JUnit 4.13测试用例验证DAO层SQL关键点webapp/是Tomcat运行时的根路径login.jsp直接通过http://localhost:8080/login.jsp访问而java/下的类必须编译成.class放入WEB-INF/classes/才能被加载——若把StudentServlet.java误拖进webapp/Tomcat启动时根本不会编译它后续所有/student/list.do请求必报404。2.3 web.xml核心配置拆解Servlet映射如何避免404黑洞!-- src/main/webapp/WEB-INF/web.xml -- ?xml version1.0 encodingUTF-8? web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd version4.0 !-- 1. 全局编码过滤器解决POST中文乱码 -- filter filter-nameCharacterEncodingFilter/filter-name filter-classcom.example.student.filter.CharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param /filter filter-mapping filter-nameCharacterEncodingFilter/filter-name url-pattern/*/url-pattern !-- 必须覆盖所有路径 -- /filter-mapping !-- 2. Servlet映射重点后缀统一为.do -- servlet servlet-nameLoginServlet/servlet-name servlet-classcom.example.student.controller.LoginServlet/servlet-class /servlet servlet-mapping servlet-nameLoginServlet/servlet-name url-pattern/login.do/url-pattern !-- 不是/login.jsp -- /servlet-mapping servlet servlet-nameStudentListServlet/servlet-name servlet-classcom.example.student.controller.StudentListServlet/servlet-class /servlet servlet-mapping servlet-nameStudentListServlet/servlet-name url-pattern/student/list.do/url-pattern /servlet-mapping !-- 3. 欢迎文件列表访问/时自动跳转login.jsp -- welcome-file-list welcome-filelogin.jsp/welcome-file /welcome-file-list /web-app逻辑说明CharacterEncodingFilter必须放在url-pattern/*/url-pattern否则AJAX POST提交的JSON数据会因编码不一致导致request.getParameter(name)返回null所有Servlet映射后缀强制为.do非.action或.html这是规避Tomcat默认JSP处理器劫持的关键——若写成/student/list.jspTomcat会直接返回JSP源码而非执行Servletwelcome-file只影响根路径/不影响/login.do等具体路径因此登录按钮的form actionlogin.do必须写对后缀。2.4 db.properties数据库连接配置为什么不能写死密码# src/main/resources/db.properties drivercom.mysql.cj.jdbc.Driver urljdbc:mysql://localhost:3306/student_db?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/Shanghai usernameroot password123456 initialSize5 maxActive20参数说明serverTimezoneAsia/ShanghaiMySQL 8.0必须显式指定时区否则new Date()插入时间戳会偏移8小时useUnicodetruecharacterEncodingutf8mb4双保险确保中文不乱码仅characterEncodingutf8mb4不够useUnicode才是开关密码明文仅限课程设计本地调试实际部署时应替换为JNDI数据源本项目DAOFactory类已预留getDataSource()扩展点。3. 核心模块拆解从LoginServlet到StudentService的完整调用链3.1 登录流程Session如何承载角色并驱动页面跳转// src/main/java/com/example/student/controller/LoginServlet.java public class LoginServlet extends HttpServlet { private UserService userService new UserServiceImpl(); Override protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 1. 获取表单参数已由CharacterEncodingFilter保证UTF-8 String username request.getParameter(username); String password request.getParameter(password); // 2. 调用Service层验证非直接查DB体现分层 User user userService.login(username, password); if (user ! null) { // 3. 将用户信息存入Sessionkey固定为user前端JSP可直接EL表达式取值 HttpSession session request.getSession(); session.setAttribute(user, user); // 存整个User对象含role字段 // 4. 根据角色重定向非转发避免URL停留在/login.do String redirectUrl; switch (user.getRole()) { case admin: redirectUrl /admin/dashboard.jsp; break; case teacher: redirectUrl /teacher/course.jsp; break; case student: redirectUrl /student/profile.jsp; break; default: redirectUrl /login.jsp?errorrole_unknown; } response.sendRedirect(request.getContextPath() redirectUrl); } else { request.setAttribute(error, 用户名或密码错误); request.getRequestDispatcher(/login.jsp).forward(request, response); } } }关键逻辑response.sendRedirect()生成302跳转浏览器地址栏URL变为/admin/dashboard.jsp符合RESTful语义若用forward()URL仍显示/login.do用户刷新时会重复提交表单session.setAttribute(user, user)存的是User实体其中role字段来自数据库user.role列值为admin/teacher/student字符串JSP中可通过${user.role}直接判断显示内容错误提示request.setAttribute(error, ...)配合% request.getAttribute(error) %在login.jsp中输出避免将错误信息暴露在URL参数里?errorxxx易被爬虫抓取。3.2 学生列表分页实现MySQL LIMIT如何与JSP EL表达式联动// src/main/java/com/example/student/controller/StudentListServlet.java public class StudentListServlet extends HttpServlet { private StudentService studentService new StudentServiceImpl(); Override protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 1. 解析分页参数默认第1页每页10条 int currentPage Integer.parseInt(request.getParameter(page) ! null ? request.getParameter(page) : 1); int pageSize 10; // 2. 调用Service获取分页数据含总记录数 PageResultStudent pageResult studentService.findPage(currentPage, pageSize); // 3. 将结果存入request域JSP通过EL取值 request.setAttribute(pageResult, pageResult); request.setAttribute(currentPage, currentPage); request.getRequestDispatcher(/WEB-INF/views/student/list.jsp) .forward(request, response); } }对应JSP分页HTMLlist.jsp片段!-- 分页导航栏 -- div classpagination c:if test${currentPage 1} a hrefstudent/list.do?page${currentPage - 1}laquo; 上一页/a /c:if c:forEach begin1 end${pageResult.totalPages} vari c:choose c:when test${i currentPage} span classcurrent${i}/span /c:when c:otherwise a hrefstudent/list.do?page${i}${i}/a /c:otherwise /c:choose /c:forEach c:if test${currentPage pageResult.totalPages} a hrefstudent/list.do?page${currentPage 1}下一页 raquo;/a /c:if /div参数说明PageResult是一个泛型POJO含ListT data、int totalPages、long totalRecords三个字段由StudentDAO执行SELECT COUNT(*)和SELECT * LIMIT ? OFFSET ?两条SQL组装JSP中${currentPage - 1}是EL表达式计算无需Java代码但必须确保currentPage是Integer类型request.setAttribute(currentPage, currentPage)传的是int非StringtotalPages (int) Math.ceil((double) totalRecords / pageSize)避免整数除法导致最后一页数据丢失。3.3 事务管理实战删除学生时如何保证选课记录同步清除// src/main/java/com/example/student/service/impl/StudentServiceImpl.java Service public class StudentServiceImpl implements StudentService { private StudentDAO studentDAO new StudentDAOImpl(); private CourseSelectionDAO csDAO new CourseSelectionDAOImpl(); // 选课记录DAO Override Transactional(rollbackFor Exception.class) public boolean deleteStudent(Long id) throws SQLException { // 1. 先删除关联的选课记录外键约束要求先清子表 int csDeleted csDAO.deleteByStudentId(id); if (csDeleted -1) { // DAO层返回-1表示SQL执行异常 throw new SQLException(删除选课记录失败); } // 2. 再删除学生主记录 int stuDeleted studentDAO.deleteById(id); if (stuDeleted ! 1) { throw new SQLException(学生记录删除失败可能ID不存在); } return true; // 事务自动提交 } }DAO层关键SQLStudentDAOImpl.javapublic int deleteById(Long id) throws SQLException { String sql DELETE FROM student WHERE id ?; return queryRunner.update(connection, sql, id); // Apache Commons DbUtils }事务生效条件Transactional注解必须作用于public方法且调用方必须是Spring容器管理的Bean本项目通过web.xml中配置ContextLoaderListener加载applicationContext.xml实现若在deleteStudent()内部直接new StudentDAOImpl().deleteById(id)事务将失效代理对象未介入rollbackFor Exception.class确保所有Exception子类都触发回滚包括SQLExceptionMySQL驱动抛出的检查异常。4. 常见问题排查那些让课程设计答辩前夜崩溃的5个真实坑4.1 现象点击登录按钮后页面空白浏览器控制台Network标签显示login.do状态码200但Response为空原因LoginServlet中response.sendRedirect()的URL路径错误。常见错误是写成/admin/dashboard.jsp绝对路径但Tomcat上下文路径非/如项目名为student-system则实际路径应为/student-system/admin/dashboard.jsp。解决强制使用request.getContextPath()拼接路径response.sendRedirect(request.getContextPath() /admin/dashboard.jsp);4.2 现象MySQL插入中文姓名显示为??但数据库字符集确认为utf8mb4原因JDBC URL缺少useUnicodetrue参数导致MySQL驱动未启用Unicode解码。解决检查db.properties确保URL包含?useUnicodetruecharacterEncodingutf8mb4且符号未被XML转义若在web.xml中配置数据源需写成amp;。4.3 现象student/list.do返回404但login.do正常原因web.xml中servlet-mapping的url-pattern与Servlet类中的WebServlet注解冲突。本项目采用纯XML配置若StudentListServlet.java顶部存在WebServlet(/student/list.do)Tomcat会优先加载注解配置而web.xml的映射被忽略。解决彻底删除StudentListServlet.java中的WebServlet注解仅保留web.xml配置。4.4 现象导出Excel功能点击无反应浏览器控制台报ReferenceError: exportToExcel is not defined原因export.js未被list.jsp正确引入或JS函数名与HTML中onclickexportToExcel()不匹配。解决检查list.jsp头部是否包含script src${pageContext.request.contextPath}/js/export.js/script并确认export.js中函数定义为function exportToExcel() { /* ... */ } // 不能是export_to_excel或ExportToExcel4.5 现象管理员修改学生信息后页面显示更新成功但数据库未变化原因StudentUpdateServlet中request.getParameter()获取的ID为String类型而DAO层SQL使用WHERE id ?时MySQL将字符串ID隐式转换为数字导致WHERE id 123 带空格匹配失败。解决在Servlet中强转并trimString idStr request.getParameter(id).trim(); Long id Long.parseLong(idStr); // 抛出NumberFormatException则前端校验不严5. 二次开发改造指南从“能跑”到“能讲清楚原理”的3个关键动作5.1 在不改DAO的前提下给学生列表增加按专业模糊搜索需求在list.jsp顶部添加搜索框输入“计算机”后只显示major LIKE %计算机%的学生。改造步骤修改StudentListServlet.java的doGet()方法解析新增参数String majorKeyword request.getParameter(major); // 新增参数 if (majorKeyword null) majorKeyword ; // 传入Service层 PageResultStudent pageResult studentService.findPage(currentPage, pageSize, majorKeyword);修改StudentService接口及实现增加majorKeyword参数// StudentService.java PageResultStudent findPage(int currentPage, int pageSize, String majorKeyword); // StudentServiceImpl.java Override public PageResultStudent findPage(int currentPage, int pageSize, String majorKeyword) { // 构造动态SQL注意防SQL注入 String baseSql SELECT * FROM student WHERE 11; ListObject params new ArrayList(); if (!majorKeyword.trim().isEmpty()) { baseSql AND major LIKE ?; params.add(% majorKeyword.trim() %); } // 后续拼接LIMIT语句... }在list.jsp中添加搜索表单保持GET方法以便分页链接兼容form methodget classform-inline input typetext namemajor value${param.major} placeholder按专业搜索 classform-control button typesubmit classbtn btn-primary搜索/button !-- 保留当前page参数 -- input typehidden namepage value${param.page ! null ? param.page : 1} /form注意value${param.major}确保搜索后页码输入框仍显示原关键词提升用户体验input typehidden传递page参数避免搜索后回到第1页。5.2 将JSP页面升级为Bootstrap 5响应式布局兼容手机端原项目用Bootstrap 4.6升级到5.3需调整三处CSS/JS引用替换webapp/css/bootstrap.min.css为5.3版本webapp/js/bootstrap.bundle.min.js5.0移除了jQuery依赖栅格类名col-md-4→col-md5.0默认均分btn btn-default→btn btn-outline-secondary表单验证移除div classhas-error改用div classinvalid-feedback配合is-invalid类。关键代码对比登录表单!-- Bootstrap 4.6 -- div classform-group has-error label密码/label input classform-control namepassword span classhelp-block密码不能为空/span /div !-- Bootstrap 5.3 -- div classform-floating mb-3 input typepassword classform-control is-invalid idpassword namepassword label forpassword密码/label div classinvalid-feedback密码不能为空/div /div5.3 用Log4j2记录用户操作日志满足课程设计“系统维护”评分项目标记录每次登录成功的用户名、IP、时间。实施步骤在pom.xml中添加Log4j2依赖本项目已含确认版本为2.20.0dependency groupIdorg.apache.logging.log4j/groupId artifactIdlog4j-core/artifactId version2.20.0/version /dependency创建src/main/resources/log4j2.xml?xml version1.0 encodingUTF-8? Configuration statusWARN Appenders File nameOperateLog fileNamelogs/operate.log PatternLayout pattern%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n/ /File /Appenders Loggers Logger namecom.example.student.controller.LoginServlet levelinfo additivityfalse AppenderRef refOperateLog/ /Logger Root levelerror AppenderRef refConsole/ /Root /Loggers /Configuration在LoginServlet.java登录成功分支添加日志import org.apache.logging.log4j.LogManager; import org.apache.logging.log4j.Logger; public class LoginServlet extends HttpServlet { private static final Logger logger LogManager.getLogger(LoginServlet.class); // ... 在if (user ! null) 块内添加 String clientIP getClientIP(request); logger.info(用户[{}]登录成功IP:[{}], username, clientIP); } private String getClientIP(HttpServletRequest request) { String xip request.getHeader(X-Real-IP); String xfor request.getHeader(X-Forwarded-For); if (xfor ! null !xfor.isEmpty() !unknown.equalsIgnoreCase(xfor)) { return xfor.split(,)[0].trim(); } return xip ! null !unknown.equalsIgnoreCase(xip) ? xip : request.getRemoteAddr(); }补充说明getClientIP()方法兼容Nginx反向代理场景课程设计虽不用但写上体现工程意识日志文件logs/operate.log会自动创建在Tomcatbin目录同级答辩时可当场打开展示实时日志滚动。从那以后我每次带课设都会在学生第一次提交前强制他们用mvn clean compile检查编译错误再用telnet localhost 3306确认MySQL端口连通性最后用Postman发一个POST /login.do看响应头是否含Set-Cookie: JSESSIONID——这三步走完90%的部署问题就提前暴露了。希望帮到你。本文还有配套的精品资源点击获取