简介面向计算机专业课程设计与期末大作业场景的JavaWebMySQL大学生公寓管理系统项目包经导师指导并获98分适合正在完成课设或希望进行JavaWeb实战练习的学生。项目围绕公寓日常管理核心需求包含登录验证、宿舍楼管理、学生信息维护、楼栋管理员配置、密码修改及住宿记录查询等模块采用Servlet、JSP、DAO分层设计能清晰展示JavaWeb与MySQL交互的完整开发流程。压缩包共242个文件大小6.7MB以Java源码、JSP页面、JavaScript/CSS前端资源为主同时提供SQL数据库脚本、XML与properties配置文件、class编译产物等解压后结构清晰便于快速部署和二次学习。已有1348人浏览学习对于需要参考完整项目结构、数据库设计及功能代码实现的读者具有直接复用与借鉴价值。1. 期末大作业里最常见的 JavaWeb 公寓管理系统这个 zip 能拿来干什么这套题目几乎是 JavaWeb 课程最经典的收尾项目JSP 页面做前台Servlet 做控制DAO 自己写数据落在 MySQL。zip 里通常不是新工程而是学期中一步步攒出来的期末成果——一份源码、一份 SQL 脚本、一张设计截图。拷到本机后最常遇到的不是写不出来而是环境对不上驱动版本不对、数据库连不上、Tomcat 起来了页面 404。这类项目的价值在完整闭环登录鉴权、学生增删改查、宿舍分配以及答辩时绕不开的表设计。它适合两种人想把课设五分钟跑起来再改成自己选题的学生和想从经典三层架构里提炼可复用写法、准备迁移进工程的一线开发。服务端就是 ServletJSPJDBC 那套原教旨组合没有 Spring 帮你在背后做代理路由和事务长什么样反而看得一清二楚。2. JavaWebMySQL 本地环境怎么配JDK、Tomcat、驱动三件套2.1 为什么期末项目普遍是 ServletJSPJDBC而不是 Spring Boot课程节奏不允许先讲两周 IoC 再动手所以课堂路线通常是HTML 讲起到 JSP 的脚本片段再到 Servlet 接收请求最后补一个 JDBC 连接数据库。这个流程走完学生自然会把三层结构写成 Servlet控制 DAO数据 JSP视图。你去搜“javaweb 项目完整案例”看到的十有八九是这套骨架并不是因为它在生产环境最好而是因为它每一行代码都能对应到教材某一章。这套结构的短板也很明显数据库连接经常在 DAO 里临时创建关闭连接靠 finally查询结果集转换成对象的代码重复三遍以上。这些坏味道在期末大作业里不算扣分点但对 5 年以上的读者来说这恰恰是复习“为什么后来会出现连接池、MyBatis、Spring 管理事务”的最佳对照物。2.2 版本对应关系先看 zip 是给 MySQL 5 写的还是给 MySQL 8 写的打开 zip 先做一件事看 lib 目录里 mysql-connector-java 的 jar 包文件名。是 5.1.x 还是 8.0.x直接决定你本地要装哪个版本的服务端。很多项目跑不起来的根因不是代码错而是驱动类名和连接参数不匹配。组件课设通用版本注意事项JDK8即 1.8老 Tomcat 在 JDK 17 上会有模块访问报错Tomcat8.5 或 9.0对应 Servlet 3.1/4.0课设 web.xml 多为 2.5/3.0MySQL5.7 或 8.0本地装 8.0 最常见但代码可能是 5.x 写法驱动类MySQL 5com.mysql.jdbc.Driver连接串不用带 serverTimezone驱动类MySQL 8com.mysql.cj.jdbc.Driver连接串必须带 serverTimezone否则报 CST 错误判断标准很简单com.mysql.jdbc.Driver在 Connector/J 8.0 里已经移除如果你用的是 8.0 的 jar代码里还写老类名启动会直接ClassNotFoundException。反过来本地 MySQL 是 5.7却拿了 8.0 驱动一般也能连但字符集处理会有差异。2.3 最少依赖安装Tomcat 解压版和 MySQL 免安装版能省一半时间我一般不建议为跑一个课设去装全家桶。Tomcat 直接下 zip 解压就能用MySQL 用免安装版也只需要三步。先写一个最小配置# my.ini放在 mysql 解压目录下 [mysqld] basedirD:/soft/mysql-8.0.33-winx64 datadirD:/soft/mysql-8.0.33-winx64/data port3306 character-set-serverutf8mb4# 首次初始化--insecure 表示 root 空密码 mysqld --initialize-insecure --console # 启动--console 让日志打到当前窗口 mysqld --console # 另开终端验证端口 netstat -ano | findstr :3306初始化后 root 默认空密码用mysql -u root -p回车即可进入。下一步连上后立刻执行ALTER USER rootlocalhost IDENTIFIED BY 123456;改掉。注意datadir指向的 data 目录在初始化前不能存在MySQL 会拒绝覆盖已有数据文件。Tomcat 更简单解压后进 bin 目录执行startup.bat浏览器访问http://localhost:8080看到猫脸页面就说明 Servlet 容器活着。如果 8080 被占改conf/server.xml里的Connector port8080再重启。2.4 驱动装不上时优先查这三个点第一jar 必须放在项目的WEB-INF/lib目录放在桌面或者 JDK 的 ext 目录都没用第二如果同时存在 5.1 和 8.0 两个版本的 mysql-connectorTomcat 会随机加载其中一个排除方式是把不用的删掉第三确认驱动类名跟 jar 匹配短 class 名无法混用。提示每次改完 lib 下的 jar都要在 IDEA 里重新 Build Artifact 并把旧包删掉否则 Tomcat 加载的还是 work 目录里的缓存版本。这个坑的症状是代码明明改对了ClassNotFoundException 照报不误。3. 公寓系统数据库初始化从 zip 里的 SQL 到表结构复盘3.1 一张宿舍表和一张学生表如何表达入住关系公寓管理系统的核心对象并不复杂管理员管理宿舍宿舍容纳学生学生可能发起报修。表之间的关系只有两类学生属于宿舍报修属于学生。多数课设把外键直接挂在学生表上也就是student.dorm_id指向dorm.id。这种设计的优点是查询方便一次 JOIN 就能拿到“某个宿舍住着谁”。缺点是对“换宿历史”无能为力张三从 201 搬到 305旧记录被直接覆盖。期末大作业一般不需要历史轨迹所以不要为了显得高级而强行加第三张关联表答辩时被问“为什么这三张表就够了”能把这句话说明白反而加分。如果打开 zip 里的 SQL 发现设计成了checkin入住单表也不要觉得奇怪那是另一种思路student表不存dorm_id而是通过入住记录表维护关系。两种都能跑区别在于直接挂外键查询快但换宿要写 UPDATE单独建入住表查询多一次 JOIN但保留历史换宿记录更自然。3.2 核心表结构与关键字段取舍下面是一个典型的课设建表脚本字段做了精简但能覆盖绝大多数页面展示需求CREATE DATABASE IF NOT EXISTS dorm DEFAULT CHARSET utf8mb4; USE dorm; CREATE TABLE dorm ( id INT PRIMARY KEY AUTO_INCREMENT, building VARCHAR(20) NOT NULL COMMENT 楼栋号, room_no VARCHAR(10) NOT NULL COMMENT 房间号, bed_num SMALLINT NOT NULL DEFAULT 4 COMMENT 总床位数, remain SMALLINT NOT NULL DEFAULT 4 COMMENT 剩余床位数, UNIQUE KEY uk_room (building, room_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, stu_no VARCHAR(20) NOT NULL COMMENT 学号, name VARCHAR(32) NOT NULL, gender TINYINT DEFAULT NULL COMMENT 1男 0女, dorm_id INT DEFAULT NULL COMMENT 所在宿舍, phone VARCHAR(11) DEFAULT NULL, KEY idx_dorm (dorm_id), CONSTRAINT fk_stu_dorm FOREIGN KEY (dorm_id) REFERENCES dorm (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;三个字段选择值得在答辩时说清楚。gender用 TINYINT 而不是 VARCHAR是为了避免“男/女/未知”三种字符串带来的不可控输入页面展示时再翻译remain属于冗余字段它可以通过COUNT(*)从 student 表算出来保留它的目的是让宿舍列表页不必每次联合查询bed_num用 SMALLINT 足够宿舍楼不会超过 32 个房间每个房间不会超过 255 张床。冗余字段remain是这类系统最容易出 bug 的地方。新增学生时减一删除学生或换宿时加一任何一个分支漏了列表页的“剩余床位”就会和实际入住数对不上。改进做法是第四章末尾提到的用带条件 UPDATE 保证不越界。3.3 导入数据库的两种方式mysql 命令和 Navicat拿到 zip 里的 .sql 文件后导入之前先确认一件事文件是用什么编码保存的。Windows 记事本另存的 UTF-8 会带 BOMMySQL 5.7 在 UTF-8 模式下可能把 BOM 当字符读进去导致建库成功但表名出现异常字符。用命令导入时显式指定字符集# 方式一命令行管道导入 mysql -u root -p --default-character-setutf8mb4 dorm dorm.sql # 方式二进入客户端后 source mysql -u root -p mysql CREATE DATABASE IF NOT EXISTS dorm DEFAULT CHARACTER SET utf8mb4; mysql USE dorm; mysql SET NAMES utf8mb4; mysql source D:/downloads/dorm.sql;--default-character-set作用在客户端连接层面SET NAMES utf8mb4是把当前会话的字符集切成和库一致两者缺一都可能让中文注释或数据变成乱码。导入成功后执行SHOW TABLES;看到 admin、dorm、student 等表就基本没问题。用 Navicat 的话右键连接选择“运行 SQL 文件”文件编码选 UTF-8目标数据库先建好再导入。它本质上也是把文件内容一条条发给服务端所以同样要保证 SQL 里没有写死别的库名。3.4 连接串里的参数时区和字符集一个都不能省数据库导好了代码连不上是第二个高频故障点。课设通常把数据库配置放在src/db.properties或者DBUtil.java的静态块里内容如下jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/dorm?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456serverTimezone是 MySQL 8 的强制要求不写会报The server time zone value错误characterEncodingutf8必须配合useUnicodetrueuseSSLfalse是开发环境加速选项避免握手阶段的证书校验。如果本地 MySQL 是 8.0驱动类名写成com.mysql.jdbc.Driver这一行直接报ClassNotFound。提示密码里有特殊字符时必须 URL 编码比如要写成%40。比如 root 密码是abc123连接串写成jdbc.passwordabc%40123否则 Properties 会截断在位置。4. 源码部署到 Tomcat三层结构和一次完整运行链路4.1 解压后先认目录别急着导入 IDE正规的 JavaWeb 课设目录结构一般是这样的dorm/ ├── src/ │ ├── com/dorm/entity/ # Dorm.java Student.java Admin.java │ ├── com/dorm/dao/ # StudentDao.java DormDao.java │ ├── com/dorm/servlet/ # LoginServlet.java StudentServlet.java │ └── com/dorm/util/ # DBUtil.java ├── WebContent/ │ ├── login.jsp │ ├── student_list.jsp │ ├── css/ js/ │ └── WEB-INF/ │ └── web.xml └── lib/ # mysql-connector-java jar用 IDEA 导入时选择“新建项目 from Existing Sources”然后勾选 Web 模块把WebContent标记为 Web 资源目录。Eclipse 则直接Import - Existing Projects into Workspace因为课设大多是从 Eclipse 导出的项目里已带.project文件。4.2 配置 TomcatIDEA 和 Eclipse 的差异IDEA 的流程是Run - Edit Configurations - - Tomcat Server - Local在Deployment页签里添加 ArtifactApplication context 默认是/项目名_war_exploded。这个上下文名会直接拼在 URL 上如果 Jar/War 里项目叫dorm本地访问地址通常是http://localhost:8080/dorm_war_exploded/。Eclipse 更简单右击项目Run As - Run on Server它会自动把项目挂到 Tomcat 上。这里有个最常见的 404 陷阱Eclipse 部署时访问路径是/dorm/而 IDEA 是/dorm_war_exploded/。所以看 zip 的代码里登录成功后跳转写的是绝对路径还是相对路径就很重要。!-- 推荐写法带上项目上下文部署到哪个名字都能跑 -- % String ctx request.getContextPath(); response.sendRedirect(ctx /student/list); %硬编码/login.jsp的做法在 IDEA 部署名变化后必挂这类修改属于“解压后第一件必须做的事”。4.3 从登录 Submit 到 DAO 的请求链路看懂了链路答辩时才能接住提问。以登录为例浏览器提交表单到login这个 URLweb.xml 里的 servlet-mapping 决定由哪个类处理servlet servlet-nameLoginServlet/servlet-name servlet-classcom.dorm.servlet.LoginServlet/servlet-class /servlet servlet-mapping servlet-nameLoginServlet/servlet-name url-pattern/login/url-pattern /servlet-mapping请求先到 TomcatTomcat 根据 URL 找到 Servlet 类调用doPost()。LoginServlet 里取出username和password两个参数交给AdminDao执行SELECT * FROM admin WHERE name? AND password?返回非空就session.setAttribute(admin, admin)再重定向到宿舍列表否则request.getRequestDispatcher(login.jsp).forward(...)把错误信息带回页面。这里的两个动作值得分清sendRedirect是浏览器重新发起一次新请求地址栏会变forward是服务端内部转发地址栏不变。答辩时老师常问“为什么登录成功后刷新页面会重复提交表单”答案就是重定向只是跳走表单本身没有被二次提交刷新动作发生在跳转后的 GET 请求上所以不会重复写库。4.4 一个能直接抄的 DAO 查询写法看源码时你会发现课设里最乱的就是 DAO 层常见问题是关闭资源的代码和业务逻辑混在一起。这里给一个可以直接替换它的模板用 try-with-resources 管连接和语句用通配符传参而不是字符串拼接。public ListStudent listByKeyword(String keyword) { String sql SELECT s.id, s.stu_no, s.name, s.gender, d.room_no FROM student s LEFT JOIN dorm d ON s.dorm_id d.id WHERE s.name LIKE ? OR s.stu_no LIKE ?; ListStudent result new ArrayList(); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, % keyword %); ps.setString(2, % keyword %); try (ResultSet rs ps.executeQuery()) { while (rs.next()) { Student s new Student(); s.setId(rs.getInt(id)); s.setStuNo(rs.getString(stu_no)); s.setName(rs.getString(name)); s.setRoomNo(rs.getString(room_no)); result.add(s); } } } catch (SQLException e) { throw new RuntimeException(查询学生失败, e); } return result; }这里有三处和旧代码的典型差异值得说清楚。LIKE ?的参数绑定通配符放在 setString 里而不是拼成WHERE name LIKE %jack%这样既避免 SQL 注入也避免引号嵌套地狱返回的是空列表而不是 null页面遍历时不用判空外键字段在 SELECT 里写了别名room_no而不是d.room_no是为了让rs.getString的列名更短减少排版错误。4.5 部署后必看的三个日志位置页面 500 时第一反应不是看浏览器而是看 Tomcat 的日志目录。catalina.out是容器整体日志localhost.当天日期.log里是应用自己的异常堆栈manager相关日志则只在配了管理控制台时有意义。绝大多数课设报 NPE、ClassNotFoundException 都会打到localhost.2025-06-10.log里找Exception关键词定位即可。404 的情况分成两种URL 拼写错以及请求路径没拼项目上下文。看到 404 时先看浏览器地址栏是不是http://localhost:8080/项目名/...格式如果少了项目名Tomcat 会在根路径下找 servlet自然找不到。5. 让期末大作业更像生产代码的三个改动5.1 字符编码统一在 Filter 里做而不是每个页面 setCharacterEncoding课设里最常见的乱码场景是表单提交中文姓名后数据库存的是??。原因有两个Tomcat 8 之后 GET 请求的 URI 编码默认 UTF-8POST 请求的 body 编码默认 ISO-8859-1。只改页面pageEncoding对 POST 请求无效必须在请求进入 Servlet 前把编码切掉。最简单的方式是一个全局 FilterWebFilter(/*) public class EncodingFilter implements Filter { Override public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException { req.setCharacterEncoding(UTF-8); res.setCharacterEncoding(UTF-8); res.setContentType(text/html; charsetUTF-8); chain.doFilter(req, res); } }注意req.setCharacterEncoding要在读取参数之前调用Filter 的执行时机天然满足这个限制。如果项目 web.xml 版本是 2.5不支持WebFilter注解就手动在 web.xml 里加一条 filter 和 filter-mapping路径写/*。这个改动对 5 年以上读者来说属于基本功但对课设项目是最值得补的一环。5.2 给分配宿舍加一个“剩余床位足够”的硬校验课设代码里分配宿舍的动作通常是两条 SQL查宿舍当前剩余床位大于 0 则插入学生记录再减一。这两步之间没有事务并发下会出现超卖。即便是期末演示老师也可能问“如果两个管理员同时给 201 分配最后一个床位怎么办”。标准答案是把查和改合并成一条带条件的 UPDATEUPDATE dorm SET remain remain - 1 WHERE id ? AND remain 0;UPDATE返回影响行数等于 1 说明抢床位成功等于 0 说明满员。配合事务把插入学生和扣减床位放进同一个connection.setAutoCommit(false)块里要么都成功要么都回滚。这个写法比“先 SELECT 再 UPDATE”少一次查询还天然规避并发问题答辩老师听到这里基本不会再追问。5.3 准备一份环境核对表演示时按顺序过期末演示现场翻车的概率远高于代码写错。把下面这张表打印出来或贴在代码注释里部署时逐项打勾检查项验证方法出现问题时的典型现象MySQL 端口在 3306netstat -ano | findstr :3306连接超时Access denied连接串密码与本地一致看 db.properties 是否被 IDE 改过Communications link failure驱动 jar 在 WEB-INF/lib打开部署后的WEB-INF/lib确认ClassNotFoundExceptionTomcat 端口未冲突netstat -ano | findstr :8080Address already in use数据库字符集是 utf8mb4SHOW VARIABLES LIKE character_set_database;中文乱码再补一步把宿舍列表、学生增删改、分配床位、模糊查询、退出登录各走一遍确认操作后刷新列表页数据一致。演示前按此顺序走一遍页面十秒内能弹到评委面前。本文还有配套的精品资源点击获取