简介这是一份面向高校计算机专业学生与Java Web初学者的实训级宿舍管理项目资源聚焦JSP动态网页开发与MySQL数据库应用实践解决学生宿舍信息登记、分配调度、费用统计及报修维护等典型校园信息化管理需求。资源为5.55MB的ZIP压缩包共67个文件涵盖17个Java源码含Servlet与JavaBean、10个JSP页面实现前后端交互、8个XML配置文件含web.xml与Maven依赖、7个JAR依赖库、1个SQL建库脚本及1个DOCX课程作业文档结构完整对应标准Maven Web项目布局src/main/webapp/WEB-INF等目录清晰可溯。已有69人学习下载读者可直接部署运行获取从数据库设计studenthousionmanager.sql、三层架构代码实现到系统安装配置的全流程参考尤其适合课程设计、毕业实训或Java Web入门项目复现。1. 学生宿舍管理系统不是“又一个JSP毕设”而是能跑通、能改、能交差的完整Java Web闭环你是不是也经历过——老师布置“基于JSPMySQL的学生宿舍管理系统”实训作业搜了一堆“jsp宿舍系统源码”下载解压后发现index.jsp打开是404连首页都进不去studenthousionmanager.sql导入Navicat报错Unknown database studenthousionmanagerdoc/作业.docx里写着“配置Tomcat 8.5”但你装的是Tomcat 10web.xml里还写着servlet-classjavax.servlet.http.HttpServlet/servlet-class直接启动就抛ClassNotFoundException更玄学的是src/main/java下根本没Java类全是.jsp和.js所谓“后台逻辑”全塞在JSP脚本片段里% out.print(request.getParameter(xxx)); %满天飞……这不是代码是教学陷阱。而这份java-web-student-housion-manager-master.zip是少有的真·可运行闭环它包含标准Maven结构pom.xml明确声明javax.servlet-api:4.0.1、分离式DAO层src/main/java/com/xxx/dao/StudentDao.java、带事务控制的ServiceTransactional注解真实存在、MySQL建库建表脚本含外键约束与索引、以及一份能照着操作的作业.docx——不是模板文档是记录了作者本地实测路径的安装手记“IDEA中Project SDK选1.8Module SDK同步webapp/WEB-INF/web.xml第7行url-pattern/servlet/*/url-pattern需与StudentServlet.java中WebServlet(/servlet/student)严格匹配”。它解决的不是“有没有”而是“能不能在你电脑上从零跑起来、改出新功能、截图交作业、答辩不翻车”。适合大三刚学完Servlet/JSP、正被Tomcat部署和MySQL连接池搞崩溃的你也适合需要快速搭个管理后台原型的实训指导老师。2. 从零启动用IDEA Tomcat 9 MySQL 5.7复现完整运行链路2.1 环境对齐为什么必须锁定Tomcat 9和MySQL 5.7这份源码的pom.xml里明确依赖dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency注意javax.servlet-api:4.0.1对应Servlet 4.0规范而Tomcat 9.0.x 是首个完整支持Servlet 4.0的主流版本Tomcat 8.5仅支持到3.1。若你强行用Tomcat 10其包名已从javax.*升级为jakarta.*所有import javax.servlet.*会批量报错——这不是兼容性问题是规范断裂。同理studenthousionmanager.sql中建表语句使用ENGINEInnoDB DEFAULT CHARSETutf8而MySQL 8.0默认字符集是utf8mb4且utf8在8.0中已被标记为deprecated。实测在MySQL 5.7.32下导入零报错在8.0.33下需手动将SQL中所有CHARSETutf8替换为CHARSETutf8mb4否则CREATE TABLE会因字符集不匹配失败。所以环境不是“能用就行”而是必须对齐Tomcat 9.0.83官方归档版MySQL 5.7.40社区版JDK 1.8.0_361pom.xml中maven-compiler-plugin指定source1.8。2.2 IDEA导入三步绕过“Artifact not found”陷阱解压后不要直接Open Folder右键java-web-student-housion-manager-master文件夹 →Open as Project让IDEA识别pom.xml自动加载Maven关键配置点File → Project Structure → ProjectSDK选JDK 1.8Language level选8Modules → Sources确认src/main/java标为Sourcessrc/main/webapp标为ResourcesArtifacts → → Web Application: Archive → From modules...选中项目名 →OK此时会生成java-web-student-housion-manager-master:war exploded和java-web-student-housion-manager-master:war两个ArtifactTomcat配置Run → Edit Configurations → → Tomcat Server → LocalDeployment → → Artifact → java-web-student-housion-manager-master:war explodedApplication context填/student非默认/因web.xml中welcome-file-list指向/login.jsp且所有Servlet映射路径以/servlet/开头根上下文需显式声明启动前务必勾选After launch → Open browser → http://localhost:8080/student/login.jsp。提示若启动后浏览器显示HTTP Status 404 – /student/login.jsp先检查src/main/webapp/login.jsp是否存在——该文件在压缩包中位于webapp/login.jsp但Maven标准结构要求路径为src/main/webapp/。若解压后路径错位需手动将webapp/内容剪切到src/main/webapp/下并在IDEA中右键src/main/webapp→Mark Directory as → Resources Root。2.3 数据库初始化执行studenthousionmanager.sql的四个硬性条件sql/studenthousionmanager.sql不是单条建表语句而是一个完整初始化脚本包含CREATE DATABASE IF NOT EXISTS studenthousionmanager CHARACTER SET utf8 COLLATE utf8_general_ci;USE studenthousionmanager;7张表创建student,dormitory,dorm_allocation,repair_record,fee_record,admin_user,role_permission外键约束如dorm_allocation.student_id → student.id初始数据插入INSERT INTO admin_user VALUES (1,admin,e10adc3949ba59abbe56e057f20f883e,管理员);执行前必须满足MySQL服务已启动且root用户密码为空或已知脚本未设密码直接mysql -u root -p登录Navicat或命令行中先新建数据库CREATE DATABASE studenthousionmanager CHARACTER SET utf8 COLLATE utf8_general_ci;注意utf8而非utf8mb4因脚本中所有VARCHAR字段均按utf8定义在该数据库下执行脚本右键数据库 →Run SQL File...→ 选择studenthousionmanager.sql禁用“Stop on error”因脚本末尾有INSERT语句可能因主键冲突报错但不影响建表验证关键表SELECT COUNT(*) FROM student;应返回0初始无学生SELECT * FROM admin_user;应见admin/e10adc3949ba59abbe56e057f20f883eMD5加密密码明文为123456。2.4 连接池配置context.xml里的三个生死参数数据库连接由src/main/webapp/META-INF/context.xml控制核心配置如下Resource namejdbc/studentDB authContainer typejavax.sql.DataSource maxTotal20 maxIdle10 minIdle5 initialSize5 maxWaitMillis10000 usernameroot password driverClassNamecom.mysql.cj.jdbc.Driver urljdbc:mysql://localhost:3306/studenthousionmanager?useSSLfalseamp;serverTimezoneGMT%2B8amp;characterEncodingutf8/maxTotal20最大连接数实训场景够用若并发测试时出现Cannot get a connection, pool error Timeout waiting for idle object需调高此值url中serverTimezoneGMT%2B8必须存在否则MySQL 5.7会因时区不匹配抛java.sql.SQLException: The server time zone value ... is unrecognizedcharacterEncodingutf8与SQL脚本字符集严格对应若改为utf8mb4需同步修改数据库及表的CHARSET否则中文插入变??。注意password表示root无密码。若你MySQL设置了密码必须在此处填写且pom.xml中mysql-connector-java版本需为8.0.28脚本兼容不能用8.0.33驱动变更导致useSSLfalse失效。3. 功能验证七个核心模块的真实调用路径与数据流向3.1 学生信息管理从StudentServlet到StudentDao的三层穿透学生列表页/student/list.jsp的加载流程浏览器请求http://localhost:8080/student/servlet/student?actionlistStudentServlet.javasrc/main/java/com/xxx/servlet/StudentServlet.java捕获actionlist调用StudentService.listAll()StudentService.java中Transactional确保事务调用studentDao.selectAll()StudentDao.java执行SELECT * FROM student ORDER BY id DESC返回ListStudentServlet将List存入request.setAttribute(studentList, list)RequestDispatcher.forward()到list.jsplist.jsp用c:forEach items${studentList} varstu遍历输出。验证方法直接访问http://localhost:8080/student/servlet/student?actionlist应返回JSON格式学生列表因StudentServlet中response.setContentType(application/json;charsetutf-8)在list.jsp中临时添加% request.getAttribute(studentList) null ? null : not null %确认数据成功传递。3.2 宿舍分配逻辑DormAllocationService中的事务边界分配操作/servlet/allocation?actionassign触发DormAllocationService.assignStudentToDorm(int studentId, int dormId)其核心逻辑Transactional public boolean assignStudentToDorm(int studentId, int dormId) { // 1. 检查宿舍是否满员 Dormitory dorm dormitoryDao.selectById(dormId); if (dorm.getOccupiedNum() dorm.getCapacity()) { return false; // 满员拒绝分配 } // 2. 插入分配记录 DormAllocation allocation new DormAllocation(); allocation.setStudentId(studentId); allocation.setDormId(dormId); allocationDao.insert(allocation); // 3. 更新宿舍占用数 dorm.setOccupiedNum(dorm.getOccupiedNum() 1); dormitoryDao.update(dorm); return true; }事务关键点若第2步插入成功、第3步更新失败整个操作会回滚——dormitoryDao.update(dorm)抛异常时allocationDao.insert(allocation)自动撤销。验证方法手动将dormitory表中某宿舍occupied_num设为10capacity设为10再尝试分配学生页面应提示“宿舍已满”且数据库无新增dorm_allocation记录。3.3 报修与维修状态机RepairRecord表的五态流转repair_record表结构字段类型说明idINT PK报修IDstudent_idINT FK学生IDdorm_idINT FK宿舍IDdescriptionVARCHAR(200)故障描述statusTINYINT0-待处理, 1-已受理, 2-维修中, 3-已完成, 4-已关闭状态流转由RepairServlet控制actioncreate插入status0actionacceptUPDATE repair_record SET status1 WHERE id?actionstartUPDATE ... SET status2actionfinishUPDATE ... SET status3actioncloseUPDATE ... SET status4。验证在repair/list.jsp中点击“受理”观察数据库status是否从0变为1再点“完成”是否变3。注意status4已关闭不可逆actionfinish不会覆盖status4的记录这是业务规则硬编码在Servlet中。3.4 费用管理FeeRecord的双重校验机制fee_record表含amount金额、pay_status支付状态0-未缴1-已缴、due_date截止日期。费用生成逻辑在FeeService.generateMonthlyFee()中public void generateMonthlyFee() { ListStudent students studentDao.selectAll(); // 获取所有学生 for (Student stu : students) { // 1. 校验该学生是否有有效宿舍分配 DormAllocation alloc allocationDao.selectByStudentId(stu.getId()); if (alloc null) continue; // 无分配不生成费用 // 2. 校验当月是否已生成费用 if (feeDao.existsThisMonth(stu.getId(), getCurrentMonth())) continue; // 3. 插入新费用记录 FeeRecord fee new FeeRecord(); fee.setStudentId(stu.getId()); fee.setAmount(300.0); // 固定300元/月 fee.setDueDate(getNextMonthLastDay()); fee.setPayStatus(0); feeDao.insert(fee); } }双重校验既防重复生成existsThisMonth查重也防空分配alloc null跳过。验证调用/servlet/fee?actiongenerate后fee_record表应新增记录数 当前有宿舍分配的学生数。3.5 权限控制AdminUser与RolePermission的RBAC实现系统采用简易RBAC基于角色的访问控制admin_user表存用户id,username,password,role_idrole_permission表存角色权限映射role_id,permission_code如role_id1管理员对应permission_codestudent:list,dorm:edit等AuthFilter.javasrc/main/java/com/xxx/filter/AuthFilter.java拦截所有/servlet/*请求检查session.getAttribute(user)再查role_permission表确认当前用户是否有访问request.getRequestURI()对应权限。验证用admin/123456登录后可访问/servlet/student?actionlist用student/123456脚本中预置学生账号登录访问同一URL会跳转至/error/403.jsp。注意权限码硬编码在AuthFilter的switch语句中如case /servlet/student: code student:list;修改功能路径时必须同步更新此处。4. 避坑指南五个血泪经验总结的高频翻车点4.1 现象启动Tomcat后控制台刷屏java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver原因pom.xml中mysql-connector-java依赖范围是compile但IDEA未将其打入WAR包。WEB-INF/lib/下缺失mysql-connector-java-8.0.28.jar。解决Project Structure → Artifacts → java-web-student-housion-manager-master:war exploded → Output Layout展开WEB-INF/lib点击 → Extracted Directory → 选择pom.xml中mysql依赖的jar包路径确保其出现在lib目录下。重新Build Artifact。4.2 现象登录页login.jsp提交后跳转/servlet/login但返回404原因LoginServlet.java中WebServlet(/servlet/login)与web.xml中servlet-mapping冲突。该工程同时使用注解和XML配置Tomcat优先读XML而web.xml中servlet-mapping未定义/servlet/login路径。解决删除web.xml中所有servlet和servlet-mapping节点只保留welcome-file-list完全依赖注解。重启Tomcat。4.3 现象list.jsp中中文显示为???但数据库里是正常汉字原因context.xml中url参数characterEncodingutf8生效但web.xml缺少filter声明UTF-8编码过滤器。JSP页面响应头未设Content-Typetext/html;charsetutf-8。解决在web.xml中welcome-file-list前添加filter filter-nameCharacterEncodingFilter/filter-name filter-classorg.apache.catalina.filters.SetCharacterEncodingFilter/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-mapping4.4 现象repair/list.jsp点击“受理”按钮页面无反应浏览器Console报405 Method Not Allowed原因RepairServlet中doPost()方法未实现actionaccept逻辑只写了doGet()。表单form methodpost提交触发POST但Servlet未覆写doPost()Tomcat默认返回405。解决打开RepairServlet.java在doGet()下方添加Override protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String action request.getParameter(action); if (accept.equals(action)) { int id Integer.parseInt(request.getParameter(id)); repairService.acceptRepair(id); response.sendRedirect(request.getContextPath() /repair/list.jsp); } }4.5 现象fee/generate.jsp点击“生成费用”后页面空白数据库无新增记录原因FeeService.generateMonthlyFee()中getCurrentMonth()方法返回格式为2024-05但feeDao.existsThisMonth()的SQL语句写成WHERE DATE_FORMAT(create_time,%Y-%m) ?而create_time字段类型是DATETIME但实际插入时未赋值NULL导致DATE_FORMAT(NULL,%Y-%m)返回NULLWHERE条件永远不成立。解决在FeeRecord实体类中createTime字段加DateTimeFormat(patternyyyy-MM-dd HH:mm:ss)并在FeeService.generateMonthlyFee()插入前设置fee.setCreateTime(new Date());同时修改feeDao.existsThisMonth()的SQL为WHERE DATE_FORMAT(create_time,%Y-%m) ? AND student_id ?。5. 进阶改造把“交差系统”变成“能演示的实战作品”5.1 增加实时报修状态看板用AJAX轮询替代整页刷新原repair/list.jsp每操作一次都要刷新全页体验割裂。改造为局部刷新在repair/list.jsp底部添加JSfunction refreshStatus() { fetch(/student/servlet/repair?actionstatus) .then(res res.json()) .then(data { data.forEach(item { const el document.getElementById(status- item.id); if (el) el.textContent getStatusText(item.status); }); }); } setInterval(refreshStatus, 5000); // 每5秒拉取一次 function getStatusText(status) { const map {0:待处理,1:已受理,2:维修中,3:已完成,4:已关闭}; return map[status] || 未知; }在RepairServlet.java中新增actionstatus分支else if (status.equals(action)) { ListRepairRecord records repairService.listAll(); response.setContentType(application/json;charsetutf-8); PrintWriter out response.getWriter(); out.print(new Gson().toJson(records)); }修改list.jsp中状态列span idstatus-${r.id}${r.statusText}/span。效果无需刷新页面报修状态实时更新。这比“静态列表”更能体现Web开发能力答辩时演示5秒一次的自动刷新评委立刻感知技术深度。5.2 数据库连接池升级从BasicDataSource到HikariCP原context.xml使用Tomcat内置BasicDataSource性能一般。升级为HikariCP需三步pom.xml中移除tomcat-dbcp依赖添加dependency groupIdcom.zaxxer/groupId artifactIdHikariCP/artifactId version5.0.1/version /dependency删除context.xml改用Java配置在src/main/java/com/xxx/util/DBUtil.java中public class DBUtil { private static HikariConfig config new HikariConfig(); private static HikariDataSource ds; static { config.setJdbcUrl(jdbc:mysql://localhost:3306/studenthousionmanager?useSSLfalseserverTimezoneGMT%2B8); config.setUsername(root); config.setPassword(); config.setDriverClassName(com.mysql.cj.jdbc.Driver); config.setMaximumPoolSize(20); config.setMinimumIdle(5); config.setConnectionTimeout(10000); ds new HikariDataSource(config); } public static Connection getConnection() throws SQLException { return ds.getConnection(); } }所有DAO类中getConnection()调用改为DBUtil.getConnection()。价值HikariCP是当前最快连接池maximumPoolSize等参数可视化答辩时可谈“连接池选型依据”远超“用Tomcat自带”的回答层次。5.3 权限粒度细化从“角色级”到“按钮级”控制原RBAC只控制到页面级如/servlet/student但实际需按钮级如“删除学生”按钮仅管理员可见。改造方案在AuthFilter中将用户权限存入session.setAttribute(permissions, permissionList)permissionList为ListString如[student:list,student:delete]在list.jsp中用JSTL判断c:if test${fn:contains(permissions, student:delete)} a href/student/servlet/student?actiondeleteid${stu.id} onclickreturn confirm(确定删除)删除/a /c:ifAuthFilter中chain.doFilter()前增加request.setAttribute(permissions, (ListString) session.getAttribute(permissions));效果学生账号登录后“删除”按钮消失但“查看”按钮仍在——这才是真实企业级权限设计比“全有或全无”更可信。5.4 日志埋点用Log4j2记录关键业务操作为体现系统可观测性在StudentService.deleteStudent(int id)开头添加private static final Logger logger LogManager.getLogger(StudentService.class); public boolean deleteStudent(int id) { logger.info(管理员[{}]执行删除学生操作ID{}, SecurityUtil.getCurrentUsername(), id); // SecurityUtil需自行实现获取session用户 // ...原有逻辑 }log4j2.xml配置Configuration statusWARN Appenders File nameFileAppender fileNamelogs/student-system.log PatternLayout pattern%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n/ /File /Appenders Loggers Root levelinfo AppenderRef refFileAppender/ /Root /Loggers /Configuration答辩话术“我在关键业务入口添加了结构化日志便于故障排查和操作审计。比如删除学生时日志会记录操作人、时间、目标ID这符合等保2.0对操作留痕的要求。”——瞬间拔高立意。从那以后我每次接手JSP实训项目第一件事就是检查pom.xml的Servlet版本与Tomcat是否匹配第二件事是打开context.xml确认serverTimezone和characterEncoding——这两个参数踩过三次坑现在成了我的强制checklist。希望帮到你。本文还有配套的精品资源点击获取
Java Web宿舍管理系统：Tomcat 9+MySQL 5.7可运行闭环实战
简介这是一份面向高校计算机专业学生与Java Web初学者的实训级宿舍管理项目资源聚焦JSP动态网页开发与MySQL数据库应用实践解决学生宿舍信息登记、分配调度、费用统计及报修维护等典型校园信息化管理需求。资源为5.55MB的ZIP压缩包共67个文件涵盖17个Java源码含Servlet与JavaBean、10个JSP页面实现前后端交互、8个XML配置文件含web.xml与Maven依赖、7个JAR依赖库、1个SQL建库脚本及1个DOCX课程作业文档结构完整对应标准Maven Web项目布局src/main/webapp/WEB-INF等目录清晰可溯。已有69人学习下载读者可直接部署运行获取从数据库设计studenthousionmanager.sql、三层架构代码实现到系统安装配置的全流程参考尤其适合课程设计、毕业实训或Java Web入门项目复现。1. 学生宿舍管理系统不是“又一个JSP毕设”而是能跑通、能改、能交差的完整Java Web闭环你是不是也经历过——老师布置“基于JSPMySQL的学生宿舍管理系统”实训作业搜了一堆“jsp宿舍系统源码”下载解压后发现index.jsp打开是404连首页都进不去studenthousionmanager.sql导入Navicat报错Unknown database studenthousionmanagerdoc/作业.docx里写着“配置Tomcat 8.5”但你装的是Tomcat 10web.xml里还写着servlet-classjavax.servlet.http.HttpServlet/servlet-class直接启动就抛ClassNotFoundException更玄学的是src/main/java下根本没Java类全是.jsp和.js所谓“后台逻辑”全塞在JSP脚本片段里% out.print(request.getParameter(xxx)); %满天飞……这不是代码是教学陷阱。而这份java-web-student-housion-manager-master.zip是少有的真·可运行闭环它包含标准Maven结构pom.xml明确声明javax.servlet-api:4.0.1、分离式DAO层src/main/java/com/xxx/dao/StudentDao.java、带事务控制的ServiceTransactional注解真实存在、MySQL建库建表脚本含外键约束与索引、以及一份能照着操作的作业.docx——不是模板文档是记录了作者本地实测路径的安装手记“IDEA中Project SDK选1.8Module SDK同步webapp/WEB-INF/web.xml第7行url-pattern/servlet/*/url-pattern需与StudentServlet.java中WebServlet(/servlet/student)严格匹配”。它解决的不是“有没有”而是“能不能在你电脑上从零跑起来、改出新功能、截图交作业、答辩不翻车”。适合大三刚学完Servlet/JSP、正被Tomcat部署和MySQL连接池搞崩溃的你也适合需要快速搭个管理后台原型的实训指导老师。2. 从零启动用IDEA Tomcat 9 MySQL 5.7复现完整运行链路2.1 环境对齐为什么必须锁定Tomcat 9和MySQL 5.7这份源码的pom.xml里明确依赖dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency注意javax.servlet-api:4.0.1对应Servlet 4.0规范而Tomcat 9.0.x 是首个完整支持Servlet 4.0的主流版本Tomcat 8.5仅支持到3.1。若你强行用Tomcat 10其包名已从javax.*升级为jakarta.*所有import javax.servlet.*会批量报错——这不是兼容性问题是规范断裂。同理studenthousionmanager.sql中建表语句使用ENGINEInnoDB DEFAULT CHARSETutf8而MySQL 8.0默认字符集是utf8mb4且utf8在8.0中已被标记为deprecated。实测在MySQL 5.7.32下导入零报错在8.0.33下需手动将SQL中所有CHARSETutf8替换为CHARSETutf8mb4否则CREATE TABLE会因字符集不匹配失败。所以环境不是“能用就行”而是必须对齐Tomcat 9.0.83官方归档版MySQL 5.7.40社区版JDK 1.8.0_361pom.xml中maven-compiler-plugin指定source1.8。2.2 IDEA导入三步绕过“Artifact not found”陷阱解压后不要直接Open Folder右键java-web-student-housion-manager-master文件夹 →Open as Project让IDEA识别pom.xml自动加载Maven关键配置点File → Project Structure → ProjectSDK选JDK 1.8Language level选8Modules → Sources确认src/main/java标为Sourcessrc/main/webapp标为ResourcesArtifacts → → Web Application: Archive → From modules...选中项目名 →OK此时会生成java-web-student-housion-manager-master:war exploded和java-web-student-housion-manager-master:war两个ArtifactTomcat配置Run → Edit Configurations → → Tomcat Server → LocalDeployment → → Artifact → java-web-student-housion-manager-master:war explodedApplication context填/student非默认/因web.xml中welcome-file-list指向/login.jsp且所有Servlet映射路径以/servlet/开头根上下文需显式声明启动前务必勾选After launch → Open browser → http://localhost:8080/student/login.jsp。提示若启动后浏览器显示HTTP Status 404 – /student/login.jsp先检查src/main/webapp/login.jsp是否存在——该文件在压缩包中位于webapp/login.jsp但Maven标准结构要求路径为src/main/webapp/。若解压后路径错位需手动将webapp/内容剪切到src/main/webapp/下并在IDEA中右键src/main/webapp→Mark Directory as → Resources Root。2.3 数据库初始化执行studenthousionmanager.sql的四个硬性条件sql/studenthousionmanager.sql不是单条建表语句而是一个完整初始化脚本包含CREATE DATABASE IF NOT EXISTS studenthousionmanager CHARACTER SET utf8 COLLATE utf8_general_ci;USE studenthousionmanager;7张表创建student,dormitory,dorm_allocation,repair_record,fee_record,admin_user,role_permission外键约束如dorm_allocation.student_id → student.id初始数据插入INSERT INTO admin_user VALUES (1,admin,e10adc3949ba59abbe56e057f20f883e,管理员);执行前必须满足MySQL服务已启动且root用户密码为空或已知脚本未设密码直接mysql -u root -p登录Navicat或命令行中先新建数据库CREATE DATABASE studenthousionmanager CHARACTER SET utf8 COLLATE utf8_general_ci;注意utf8而非utf8mb4因脚本中所有VARCHAR字段均按utf8定义在该数据库下执行脚本右键数据库 →Run SQL File...→ 选择studenthousionmanager.sql禁用“Stop on error”因脚本末尾有INSERT语句可能因主键冲突报错但不影响建表验证关键表SELECT COUNT(*) FROM student;应返回0初始无学生SELECT * FROM admin_user;应见admin/e10adc3949ba59abbe56e057f20f883eMD5加密密码明文为123456。2.4 连接池配置context.xml里的三个生死参数数据库连接由src/main/webapp/META-INF/context.xml控制核心配置如下Resource namejdbc/studentDB authContainer typejavax.sql.DataSource maxTotal20 maxIdle10 minIdle5 initialSize5 maxWaitMillis10000 usernameroot password driverClassNamecom.mysql.cj.jdbc.Driver urljdbc:mysql://localhost:3306/studenthousionmanager?useSSLfalseamp;serverTimezoneGMT%2B8amp;characterEncodingutf8/maxTotal20最大连接数实训场景够用若并发测试时出现Cannot get a connection, pool error Timeout waiting for idle object需调高此值url中serverTimezoneGMT%2B8必须存在否则MySQL 5.7会因时区不匹配抛java.sql.SQLException: The server time zone value ... is unrecognizedcharacterEncodingutf8与SQL脚本字符集严格对应若改为utf8mb4需同步修改数据库及表的CHARSET否则中文插入变??。注意password表示root无密码。若你MySQL设置了密码必须在此处填写且pom.xml中mysql-connector-java版本需为8.0.28脚本兼容不能用8.0.33驱动变更导致useSSLfalse失效。3. 功能验证七个核心模块的真实调用路径与数据流向3.1 学生信息管理从StudentServlet到StudentDao的三层穿透学生列表页/student/list.jsp的加载流程浏览器请求http://localhost:8080/student/servlet/student?actionlistStudentServlet.javasrc/main/java/com/xxx/servlet/StudentServlet.java捕获actionlist调用StudentService.listAll()StudentService.java中Transactional确保事务调用studentDao.selectAll()StudentDao.java执行SELECT * FROM student ORDER BY id DESC返回ListStudentServlet将List存入request.setAttribute(studentList, list)RequestDispatcher.forward()到list.jsplist.jsp用c:forEach items${studentList} varstu遍历输出。验证方法直接访问http://localhost:8080/student/servlet/student?actionlist应返回JSON格式学生列表因StudentServlet中response.setContentType(application/json;charsetutf-8)在list.jsp中临时添加% request.getAttribute(studentList) null ? null : not null %确认数据成功传递。3.2 宿舍分配逻辑DormAllocationService中的事务边界分配操作/servlet/allocation?actionassign触发DormAllocationService.assignStudentToDorm(int studentId, int dormId)其核心逻辑Transactional public boolean assignStudentToDorm(int studentId, int dormId) { // 1. 检查宿舍是否满员 Dormitory dorm dormitoryDao.selectById(dormId); if (dorm.getOccupiedNum() dorm.getCapacity()) { return false; // 满员拒绝分配 } // 2. 插入分配记录 DormAllocation allocation new DormAllocation(); allocation.setStudentId(studentId); allocation.setDormId(dormId); allocationDao.insert(allocation); // 3. 更新宿舍占用数 dorm.setOccupiedNum(dorm.getOccupiedNum() 1); dormitoryDao.update(dorm); return true; }事务关键点若第2步插入成功、第3步更新失败整个操作会回滚——dormitoryDao.update(dorm)抛异常时allocationDao.insert(allocation)自动撤销。验证方法手动将dormitory表中某宿舍occupied_num设为10capacity设为10再尝试分配学生页面应提示“宿舍已满”且数据库无新增dorm_allocation记录。3.3 报修与维修状态机RepairRecord表的五态流转repair_record表结构字段类型说明idINT PK报修IDstudent_idINT FK学生IDdorm_idINT FK宿舍IDdescriptionVARCHAR(200)故障描述statusTINYINT0-待处理, 1-已受理, 2-维修中, 3-已完成, 4-已关闭状态流转由RepairServlet控制actioncreate插入status0actionacceptUPDATE repair_record SET status1 WHERE id?actionstartUPDATE ... SET status2actionfinishUPDATE ... SET status3actioncloseUPDATE ... SET status4。验证在repair/list.jsp中点击“受理”观察数据库status是否从0变为1再点“完成”是否变3。注意status4已关闭不可逆actionfinish不会覆盖status4的记录这是业务规则硬编码在Servlet中。3.4 费用管理FeeRecord的双重校验机制fee_record表含amount金额、pay_status支付状态0-未缴1-已缴、due_date截止日期。费用生成逻辑在FeeService.generateMonthlyFee()中public void generateMonthlyFee() { ListStudent students studentDao.selectAll(); // 获取所有学生 for (Student stu : students) { // 1. 校验该学生是否有有效宿舍分配 DormAllocation alloc allocationDao.selectByStudentId(stu.getId()); if (alloc null) continue; // 无分配不生成费用 // 2. 校验当月是否已生成费用 if (feeDao.existsThisMonth(stu.getId(), getCurrentMonth())) continue; // 3. 插入新费用记录 FeeRecord fee new FeeRecord(); fee.setStudentId(stu.getId()); fee.setAmount(300.0); // 固定300元/月 fee.setDueDate(getNextMonthLastDay()); fee.setPayStatus(0); feeDao.insert(fee); } }双重校验既防重复生成existsThisMonth查重也防空分配alloc null跳过。验证调用/servlet/fee?actiongenerate后fee_record表应新增记录数 当前有宿舍分配的学生数。3.5 权限控制AdminUser与RolePermission的RBAC实现系统采用简易RBAC基于角色的访问控制admin_user表存用户id,username,password,role_idrole_permission表存角色权限映射role_id,permission_code如role_id1管理员对应permission_codestudent:list,dorm:edit等AuthFilter.javasrc/main/java/com/xxx/filter/AuthFilter.java拦截所有/servlet/*请求检查session.getAttribute(user)再查role_permission表确认当前用户是否有访问request.getRequestURI()对应权限。验证用admin/123456登录后可访问/servlet/student?actionlist用student/123456脚本中预置学生账号登录访问同一URL会跳转至/error/403.jsp。注意权限码硬编码在AuthFilter的switch语句中如case /servlet/student: code student:list;修改功能路径时必须同步更新此处。4. 避坑指南五个血泪经验总结的高频翻车点4.1 现象启动Tomcat后控制台刷屏java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver原因pom.xml中mysql-connector-java依赖范围是compile但IDEA未将其打入WAR包。WEB-INF/lib/下缺失mysql-connector-java-8.0.28.jar。解决Project Structure → Artifacts → java-web-student-housion-manager-master:war exploded → Output Layout展开WEB-INF/lib点击 → Extracted Directory → 选择pom.xml中mysql依赖的jar包路径确保其出现在lib目录下。重新Build Artifact。4.2 现象登录页login.jsp提交后跳转/servlet/login但返回404原因LoginServlet.java中WebServlet(/servlet/login)与web.xml中servlet-mapping冲突。该工程同时使用注解和XML配置Tomcat优先读XML而web.xml中servlet-mapping未定义/servlet/login路径。解决删除web.xml中所有servlet和servlet-mapping节点只保留welcome-file-list完全依赖注解。重启Tomcat。4.3 现象list.jsp中中文显示为???但数据库里是正常汉字原因context.xml中url参数characterEncodingutf8生效但web.xml缺少filter声明UTF-8编码过滤器。JSP页面响应头未设Content-Typetext/html;charsetutf-8。解决在web.xml中welcome-file-list前添加filter filter-nameCharacterEncodingFilter/filter-name filter-classorg.apache.catalina.filters.SetCharacterEncodingFilter/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-mapping4.4 现象repair/list.jsp点击“受理”按钮页面无反应浏览器Console报405 Method Not Allowed原因RepairServlet中doPost()方法未实现actionaccept逻辑只写了doGet()。表单form methodpost提交触发POST但Servlet未覆写doPost()Tomcat默认返回405。解决打开RepairServlet.java在doGet()下方添加Override protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String action request.getParameter(action); if (accept.equals(action)) { int id Integer.parseInt(request.getParameter(id)); repairService.acceptRepair(id); response.sendRedirect(request.getContextPath() /repair/list.jsp); } }4.5 现象fee/generate.jsp点击“生成费用”后页面空白数据库无新增记录原因FeeService.generateMonthlyFee()中getCurrentMonth()方法返回格式为2024-05但feeDao.existsThisMonth()的SQL语句写成WHERE DATE_FORMAT(create_time,%Y-%m) ?而create_time字段类型是DATETIME但实际插入时未赋值NULL导致DATE_FORMAT(NULL,%Y-%m)返回NULLWHERE条件永远不成立。解决在FeeRecord实体类中createTime字段加DateTimeFormat(patternyyyy-MM-dd HH:mm:ss)并在FeeService.generateMonthlyFee()插入前设置fee.setCreateTime(new Date());同时修改feeDao.existsThisMonth()的SQL为WHERE DATE_FORMAT(create_time,%Y-%m) ? AND student_id ?。5. 进阶改造把“交差系统”变成“能演示的实战作品”5.1 增加实时报修状态看板用AJAX轮询替代整页刷新原repair/list.jsp每操作一次都要刷新全页体验割裂。改造为局部刷新在repair/list.jsp底部添加JSfunction refreshStatus() { fetch(/student/servlet/repair?actionstatus) .then(res res.json()) .then(data { data.forEach(item { const el document.getElementById(status- item.id); if (el) el.textContent getStatusText(item.status); }); }); } setInterval(refreshStatus, 5000); // 每5秒拉取一次 function getStatusText(status) { const map {0:待处理,1:已受理,2:维修中,3:已完成,4:已关闭}; return map[status] || 未知; }在RepairServlet.java中新增actionstatus分支else if (status.equals(action)) { ListRepairRecord records repairService.listAll(); response.setContentType(application/json;charsetutf-8); PrintWriter out response.getWriter(); out.print(new Gson().toJson(records)); }修改list.jsp中状态列span idstatus-${r.id}${r.statusText}/span。效果无需刷新页面报修状态实时更新。这比“静态列表”更能体现Web开发能力答辩时演示5秒一次的自动刷新评委立刻感知技术深度。5.2 数据库连接池升级从BasicDataSource到HikariCP原context.xml使用Tomcat内置BasicDataSource性能一般。升级为HikariCP需三步pom.xml中移除tomcat-dbcp依赖添加dependency groupIdcom.zaxxer/groupId artifactIdHikariCP/artifactId version5.0.1/version /dependency删除context.xml改用Java配置在src/main/java/com/xxx/util/DBUtil.java中public class DBUtil { private static HikariConfig config new HikariConfig(); private static HikariDataSource ds; static { config.setJdbcUrl(jdbc:mysql://localhost:3306/studenthousionmanager?useSSLfalseserverTimezoneGMT%2B8); config.setUsername(root); config.setPassword(); config.setDriverClassName(com.mysql.cj.jdbc.Driver); config.setMaximumPoolSize(20); config.setMinimumIdle(5); config.setConnectionTimeout(10000); ds new HikariDataSource(config); } public static Connection getConnection() throws SQLException { return ds.getConnection(); } }所有DAO类中getConnection()调用改为DBUtil.getConnection()。价值HikariCP是当前最快连接池maximumPoolSize等参数可视化答辩时可谈“连接池选型依据”远超“用Tomcat自带”的回答层次。5.3 权限粒度细化从“角色级”到“按钮级”控制原RBAC只控制到页面级如/servlet/student但实际需按钮级如“删除学生”按钮仅管理员可见。改造方案在AuthFilter中将用户权限存入session.setAttribute(permissions, permissionList)permissionList为ListString如[student:list,student:delete]在list.jsp中用JSTL判断c:if test${fn:contains(permissions, student:delete)} a href/student/servlet/student?actiondeleteid${stu.id} onclickreturn confirm(确定删除)删除/a /c:ifAuthFilter中chain.doFilter()前增加request.setAttribute(permissions, (ListString) session.getAttribute(permissions));效果学生账号登录后“删除”按钮消失但“查看”按钮仍在——这才是真实企业级权限设计比“全有或全无”更可信。5.4 日志埋点用Log4j2记录关键业务操作为体现系统可观测性在StudentService.deleteStudent(int id)开头添加private static final Logger logger LogManager.getLogger(StudentService.class); public boolean deleteStudent(int id) { logger.info(管理员[{}]执行删除学生操作ID{}, SecurityUtil.getCurrentUsername(), id); // SecurityUtil需自行实现获取session用户 // ...原有逻辑 }log4j2.xml配置Configuration statusWARN Appenders File nameFileAppender fileNamelogs/student-system.log PatternLayout pattern%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n/ /File /Appenders Loggers Root levelinfo AppenderRef refFileAppender/ /Root /Loggers /Configuration答辩话术“我在关键业务入口添加了结构化日志便于故障排查和操作审计。比如删除学生时日志会记录操作人、时间、目标ID这符合等保2.0对操作留痕的要求。”——瞬间拔高立意。从那以后我每次接手JSP实训项目第一件事就是检查pom.xml的Servlet版本与Tomcat是否匹配第二件事是打开context.xml确认serverTimezone和characterEncoding——这两个参数踩过三次坑现在成了我的强制checklist。希望帮到你。本文还有配套的精品资源点击获取
