企业官网建设流程全解析

简介：基于JavaWeb的学生宿舍管理系统毕业设计源码，面向计算机相关专业学生，可直接用于毕业设计、期末大作业或JavaWeb课程设计参考。压缩包共203个文件，约7.22MB，核心包括22个JSP动态页面、21个Java后端类、73个JavaScript交互脚本、16个CSS样式表、35张界面图片，另含数据库SQL脚本与第三方JAR包，前端界面、业务逻辑与环境配置一应俱全。项目随附详细安装教程（README文件夹），针对数据库连接、IDEA项目SDK与模块导入等常见问题给出图文说明，帮助初学者规避环境配置报错，快速运行。源码注释完善，覆盖学生管理、宿舍分配、报修登记等典型模块，前端基于Bootstrap样式库搭建，便于理解JavaWeb全栈开发流程并二次扩展。已有3254人学习下载，适合需要高质量参考模板的毕业设计或期末项目场景。

1. JavaWeb 学生宿舍管理系统：源码能跑只是起点，卡你的多半是环境

学生宿舍管理系统在 JavaWeb 毕设选题里属于“卷但稳”的方向。它没有订单超卖那种高并发难题，业务边界非常清楚：学生信息、宿舍分配、入住退宿记录，每一张表都能在答辩时用一句话讲明白。这份源码的可贵之处在于注释完整，从 DbUtil 到 Servlet 的每个方法都有中文说明，适合拿来做期末大作业或毕业设计底子。不过要注意，代码能跑不等于工程能跑。我在 IDEA 里复现时遇到的第一道坎，不是 Java 代码，而是数据库连接串里一个看不见的参数，以及模块导入时 IDE 的重复行为。这俩坑，几乎每个用这个项目的人都会踩一遍。

2. 项目结构与数据层设计：为什么先看 DbUtil 而不是先看 JSP

拿到源码的第一步不是急着跑，而是先读目录。JavaWeb 项目和 Spring Boot 那种“一个 main 方法启动一切”的结构截然不同，它的入口分散在 web.xml、Servlet 注解和 JSP 页面里。不先搞清楚谁在启动时加载、谁按请求触发，后面改配置容易改出连锁问题。这一章以本项目源码里的典型结构为例，把数据层到表现层的调用链拆开来看。

2.1 解压后先认目录：src、WebContent、lib 在 JavaWeb 里的分工

解压 StudentDorm.zip 之后，看到的目录结构通常长这样，不同版本在文件名上会有细微差异：

StudentDorm/ ├── .idea/ # IDEA 工程配置，包含 SDK 等元数据 ├── src/ │ └── com/ │ └── util/ │ └── DbUtil.java # 数据库连接工具 │ └── servlet/ # 登录、学生管理、宿舍管理等请求入口 │ └── model/ # JavaBean，对应数据库表 │ └── dao/ # 数据访问层 ├── WebContent/ # Web 根目录 │ ├── css/ │ │ ├── bootstrap.css │ │ ├── bootstrap.min.css │ │ ├── bootstrap-responsive.css │ │ └── jquery.dataTables.css │ ├── js/ │ ├── images/ │ └── WEB-INF/ │ ├── web.xml # 路由与过滤器声明 │ └── lib/ # 项目依赖的 jar 包 └── README # 部署说明

关键目录的职责和常见误用，可以对照下面这张表看：

这里有一个判断项目“老不老”的技巧：如果存在 web.xml，并且 Servlet 通过<servlet-mapping>配置，说明走的是传统 Servlet 3.x 写法；如果 Servlet 类上直接写@WebServlet，则更贴近 Tomcat 7+。本项目中两种写法可能混用，这并不矛盾，但修改映射时要先在文件里搜索该类是否同时存在两处声明，否则会出现 404 或 405。

2.2 DbUtil.java 的连接参数与 MySQL 8 驱动行为

在 IDEA 里配置完 SDK 后，第一个必须改的文件就是 DbUtil.java。摘要里已经明确要求修改userName与userPwd，这一步不做，点击登录会直接进入空白页，控制台报java.sql.SQLNonTransientConnectionException: Public Key Retrieval is not allowed。这个错误本质上不是密码错误，而是 MySQL 8 的认证机制与驱动默认配置不匹配导致的。

一个典型的 DbUtil 长这样：

package com.util; import java.sql.*; public class DbUtil { private static final String DRIVER = "com.mysql.cj.jdbc.Driver"; // 注意：useSSL=false 只用于本地开发，生产环境应使用 SSL private static final String URL = "jdbc:mysql://localhost:3306/student_dorm" + "?useUnicode=true&characterEncoding=utf8" + "&serverTimezone=Asia/Shanghai" + "&useSSL=false&allowPublicKeyRetrieval=true"; private static final String userName = "root"; // 改你的数据库账号 private static final String userPwd = "123456"; // 改你的数据库密码 static { try { Class.forName(DRIVER); } catch (ClassNotFoundException e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, userName, userPwd); } public static void close(Connection conn, Statement st, ResultSet rs) { if (rs != null) { try { rs.close(); } catch (SQLException ignored) {} } if (st != null) { try { st.close(); } catch (SQLException ignored) {} } if (conn != null) { try { conn.close(); } catch (SQLException ignored) {} } } }

连接串里的参数逐个拆开看：

• useUnicode=true&characterEncoding=utf8：保证中文宿舍楼名称和姓名不乱码。如果 JSP 页面声明的是 UTF-8，但数据库连接不是 UTF-8，新增的学生记录会变成问号。
• serverTimezone=Asia/Shanghai：MySQL 8 驱动要求显式声明时区，否则在CST这类模糊时区上报错。
• useSSL=false：本地开发关闭加密，避免证书验证带来的启动延迟。
• allowPublicKeyRetrieval=true：这是解决Public Key Retrieval is not allowed的关键参数。MySQL 8 默认使用caching_sha2_password插件，客户端第一次连接需要服务端公钥，驱动默认不允许从服务端获取公钥，所以要加这个参数放行。

摘要里提示的修改位置是src/com/util/DbUtil.java下的userName与userPwd两个变量。有些版本的工具类把变量命名为username或dbPassword，修改前先在文件里搜user和pwd关键字，不要只搜userName，避免漏改。

2.3 Servlet 与 JSP 的分工：请求是怎么从表单走到数据库的

学生宿舍管理系统最常见的交互是“管理员登录后，在列表页新增一条入住记录”。这个请求在传统 JavaWeb 里的路径是：用户点击提交，表单数据发到dormServlet?action=add，Servlet 接收参数后交给 DAO 层写库，成功后重定向回列表页。下面的代码是登录模块里删掉业务细节后的骨架：

@WebServlet("/login") public class LoginServlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding("UTF-8"); String username = request.getParameter("username"); String password = request.getParameter("password"); // 常见做法：调用 UserDao 查询数据库比对密码 UserDao dao = new UserDao(); User user = dao.findByUsernameAndPassword(username, password); if (user != null) { // 登录成功后把用户对象放进 Session，后续页面靠它判断会话 request.getSession().setAttribute("currentUser", user); response.sendRedirect("index.jsp"); } else { // 失败时转发回登录页，并携带错误提示 request.setAttribute("error", "用户名或密码错误"); request.getRequestDispatcher("login.jsp").forward(request, response); } } }

说明两点：第一，request.getSession()在登录成功后才创建会话，不是每个请求都先直接 new 一个 Session，否则服务端内存压力会随着并发量上升；第二，sendRedirect与forward的区别在于，前者是浏览器重新发起一次请求，地址栏会变，后者是服务端内部跳转，地址栏不变。增删改成功后用重定向，可以避免刷新页面时重复提交表单，这是这类系统里值得坚持的习惯，答辩时可以作为“为什么要这样写”的回答素材。

3. IDEA 工程配置与数据库初始化：把源码跑起来的完整顺序

很多人在这一步绕路，不是因为代码有问题，而是不知道 IDEA 对 JavaWeb 工程的“认知”是从 Project Structure 里读出来的。SDK 版本、Modules、Libraries、Facets、Artifacts 这几个面板任何一个不对，点运行按钮时都可能出现No artifacts marked或 404，而不是直接抛异常。这一章的配置顺序按照实际导入的路径整理，照着做能省掉大部分环境类问题。README 文件夹里也有配置截图，但截图只能看到点击位置，看不到为什么要这么点。

3.1 导入前准备：JDK、Tomcat、MySQL 的版本搭配

在打开 IDEA 之前先确认三件事：JDK 是否 1.8，Tomcat 是否 8.5 或 9，MySQL 是否 8.0 或 5.7。这套项目基于 JSP/Servlet，JDK 8 + Tomcat 8.5 是最稳的组合，能少踩很多兼容性问题。

如果你本机只有 JDK 17，项目大概率在Class.forName("com.mysql.jdbc.Driver")处直接ClassNotFoundException。常见做法是在 Project Structure 里专门新建一个 JDK 1.8 的 SDK，或者把源码里老驱动类名改成com.mysql.cj.jdbc.Driver并更换WEB-INF/lib下的驱动 jar。

3.2 Project Structure 配置：SDK、Modules、Libraries 的操作顺序

这一步的操作顺序比位置更关键。摘要在 README 里已经点明：File -> Project Structure，先配置 SDK 和语言，再检查 Modules 是否为空。完整的顺序是：

1. 打开File -> Project Structure，在Project面板把Project SDK选为 1.8，Project language level选 8。
2. 检查Modules面板。如果列表为空，点+->Import Module，选中当前项目根目录StudentDorm，一直 Next。
3. 如果模块已经有了，但源码目录没有被识别，手动把src标记为 Sources，把WebContent标记为 Web Resources。
4. 检查Libraries，确认 MySQL JDBC 驱动 jar 已被 IDE 识别。如果不存在，点+->Java，从WEB-INF/lib中选择对应的mysql-connectorjar。
5. 检查Artifacts，确认有一个 Web Application Exploded 类型输出，名称为StudentDorm:war exploded。

针对摘要里“实测 IDEA 2021 会导入两次，最后一次应取消选择”的现象，我也遇到了。IDEA 2021 的导入向导会在 Modules 和 Libraries 两个面板重复询问关联。第一次是创建 Modules 时自动扫描依赖，第二次是向导结束前提示“是否同时加入 Libraries”。这里只能保留第一次，第二次不要选，否则 jar 包会出现两个副本。纯 lib 目录管理的项目出现重复依赖后，Tomcat 启动会有Duplicate jar警告，严重时出现NoSuchMethodError。README 里说的“导入两次”指的就是这个。

提示：IDEA 2021 的导入向导第二次弹窗时，不要勾选 Libraries 关联，否则工程里会出现重复依赖。

3.3 修改数据库账号密码后，怎样快速验证连接

修改完 DbUtil.java 后，先用一个最直接的手段验证数据库连接，而不是直接启动 Tomcat。在同一个包下写一个测试入口：

package com.util; import java.sql.Connection; public class TestDb { public static void main(String[] args) { try { Connection conn = DbUtil.getConnection(); System.out.println("连接成功: " + conn); DbUtil.close(conn, null, null); } catch (Exception e) { e.printStackTrace(); } } }

在 IDEA 里右键运行 main 方法。如果控制台输出连接成功: com.mysql.cj.jdbc.ConnectionImpl@xxx，说明账号、密码、URL 三个要素都正确；如果抛Access denied，优先检查密码和当前 MySQL 用户是否有 localhost 访问权限；如果还是Public Key Retrieval is not allowed，检查连接串里是否真的出现了allowPublicKeyRetrieval=true。注意这个参数必须放在 URL 的问号后面，放错位置会被当成无效参数忽略。

顺便说一个常见误区：不要为了解决这个报错，直接在 MySQL 里执行ALTER USER把认证插件改成mysql_native_password。虽然改插件也能跳过公钥获取，但相当于降低了 MySQL 8 的默认安全级别。更好的做法是保持默认认证，只加驱动参数。

3.4 Tomcat 启动前后的检查清单

配置完成后，在 IDEA 里点Add Configuration，选择 Tomcat Server -> Local，把 Artifact 部署到 Deployment 面板中。有几个常见失败点：

• 卡在Deployment is in progress：Tomcat 的临时副本没有释放，关掉 IDEA 后删除用户目录下AppData\Local\Tomcat里的临时目录再试。
• 启动后访问http://localhost:8080/报 404：把 Application context 改成/StudentDorm，再访问对应路径。
• 控制台出现Document base路径包含中文或空格：把项目移到纯英文路径下，Tomcat 对非 ASCII 路径很敏感。
• 页面样式完全丢失：检查 JSP 里引入 css 的路径是否带${pageContext.request.contextPath}，否则部署在子路径时找不到 bootstrap 样式。

4. 核心功能模块拆解：登录会话、宿舍分配与 DataTables 列表

这部分是真正写业务的地方。JavaWeb 毕设的高分点不在地图算法或高并发，而在于能不能说清楚每一张表和每一个状态位的含义。以宿舍分配为例，宿舍有正常、满员、维修三种状态，学生有待分配、在住、已退宿三种状态，这两个状态交叉，会产生至少五种业务场景。代码本身不难，难的是数据模型有没有把这些状态约束住。

4.1 登录模块：密码校验和 Session 拦截的常见写法

登录模块是评审一定会问的第一块。做好这一块的要点有两个：密码不要明文存储，会话校验不要只写在某一个 JSP 里。如果源码里用的是明文比对，答辩前至少改成 MD5 加盐，或者在文档里注明“教学演示用明文，生产环境必须换 BCrypt”。

会话校验的常见做法是写一个 Filter，而不是在每个页面重复判断：

@WebFilter("/*") public class LoginFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException { HttpServletRequest request = (HttpServletRequest) req; HttpServletResponse response = (HttpServletResponse) res; String uri = request.getRequestURI(); // 放行登录页、登录接口和静态资源 if (uri.endsWith("login.jsp") || uri.endsWith("/login") || uri.contains("/css/")) { chain.doFilter(req, res); return; } if (request.getSession().getAttribute("currentUser") == null) { response.sendRedirect("login.jsp"); return; } chain.doFilter(req, res); } }

这段过滤器的逻辑说明：uri.contains("/css/")必须放行，否则未登录用户访问登录页时，浏览器加载样式也会被拦回 login.jsp，形成无限重定向；chain.doFilter表示放行到下一个过滤器或 Servlet。用 Filter 的好处是，以后新加一个 JSP 页面，只要 URL 不命中放行规则，就自动受保护，不需要每个页面都写 session 判断。

4.2 宿舍分配与床位状态：数据库怎么建模才能避免重复入住

以这类项目的核心表逻辑为例，通常会这样建：

CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL UNIQUE, name VARCHAR(50) NOT NULL, gender CHAR(1), major VARCHAR(100), dorm_id INT, bed_no INT, status TINYINT DEFAULT 0 -- 0 待分配 1 在住 2 已退宿 ); CREATE TABLE dorm ( id INT PRIMARY KEY AUTO_INCREMENT, building_no VARCHAR(10), room_no VARCHAR(10), bed_count INT DEFAULT 6, status TINYINT DEFAULT 0 -- 0 正常 1 维修 ); CREATE TABLE check_record ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT NOT NULL, type TINYINT, -- 1 入住 2 退宿 3 调宿 operate_time DATETIME, operator VARCHAR(50), remark VARCHAR(255) );

这里的核心约束是dorm_id + bed_no不能重复，但 MySQL 对可空列的联合唯一索引有局限性。常见做法是加一张床位状态表，或者在代码里先查对应宿舍的已入住人数再决定是否允许分配。业务上需要保证的规则是：一个床位不能同时住两个人，一个学生不能同时分配两个宿舍。用唯一索引保证第一点：

ALTER TABLE student ADD UNIQUE INDEX uk_dorm_bed (dorm_id, bed_no);

宿舍管理系统的核心不是 CRUD，而是围绕“床位”这个有限资源的约束校验。答辩时把这个约束演示出来，连续提交两个学生到同一张床，第二次被拒绝，这比单纯展示页面漂亮有用得多。

4.3 Bootstrap 与 DataTables 让列表页保持整洁

项目前端资源里出现bootstrap.css、bootstrap-responsive.css和jquery.dataTables.css。这三样组合在一起的效果是：页面在不同宽度下能自适应，表格支持分页、排序和搜索，而不需要手写翻页逻辑。DataTables 的初始化代码是：

$(document).ready(function () { $("#studentTable").DataTable({ "paging": true, "pageLength": 10, "searching": true, "ordering": true, "language": { "search": "搜索：", "paginate": { "previous": "上一页", "next": "下一页" } } }); });

说明：这段代码适用于“后端一次性返回全部记录，前端本地分页”的模式。只有当数据量过大时，才需要切换成 DataTables 的服务端模式，即"serverSide": true，由后端接收start、length、search[value]参数，在 MySQL 里执行 LIMIT。学生宿舍管理系统的数据量级通常是几百个学生，本地分页完全够用。答辩时可以说“数据量在千级时本地分页的响应在毫秒级，数据量增长后预留了服务端分页的改造接口”，这句话既诚实又有技术含量。

DataTables 和 Bootstrap 搭配还有一个容易忽略的点：jquery.dataTables.css要放在bootstrap.css之后引入，否则 DataTables 的样式会被 Bootstrap 的基础样式覆盖，出现表头错位。

5. 把直连 JDBC 改成连接池，再手工验证一遍数据完整性

这份源码的 DbUtil 是最朴素的DriverManager.getConnection()，每个请求都新建物理连接，用完再关。在实验室环境能跑通，但并发上来后连接创建开销很直接：一次 TCP 握手加 MySQL 认证在十几毫秒，页面本身渲染才几十毫秒。更严重的是，如果某段代码忘了 close，数据库连接数会被打满。答辩前可以做一个小改造：把 DbUtil 换成连接池持有者，业务层代码基本不用动。

package com.util; import com.alibaba.druid.pool.DruidDataSource; import java.sql.Connection; public class DbUtil { private static DruidDataSource dataSource; static { dataSource = new DruidDataSource(); dataSource.setDriverClassName("com.mysql.cj.jdbc.Driver"); dataSource.setUrl("jdbc:mysql://localhost:3306/student_dorm" + "?useUnicode=true&characterEncoding=utf8" + "&serverTimezone=Asia/Shanghai" + "&useSSL=false&allowPublicKeyRetrieval=true"); dataSource.setUsername("root"); dataSource.setPassword("123456"); dataSource.setInitialSize(2); dataSource.setMaxActive(10); dataSource.setMaxWait(3000); } public static Connection getConnection() throws Exception { return dataSource.getConnection(); } }

使用连接池后，getConnection()拿到的是池化连接，调用close()并不会关闭物理连接，而是归还到池中。使用 Druid 时要在WEB-INF/lib下放入 druid jar。setMaxWait(3000)必须设置，否则连接池被耗尽时业务线程会无限等待，页面看起来像死掉一样；setInitialSize(2)表示 Tomcat 启动时立刻预创建两个连接，能提前暴露数据库配置问题，而不是等第一个请求进来才报错。

改造完连接池，再做三个快速自查，确认项目在“高分”层面经得起追问：

• 未登录直接访问http://localhost:8080/studentList.jsp，观察是否被 Filter 弹回登录页。
• 在入住表单里填入<script>alert(1)</script>，提交后打开列表页，看脚本是否被原样输出。如果输出成字符串，说明有转义处理；如果弹窗，说明存在 XSS 漏洞，需要用 JSTL 的<c:out>替换<%= %>输出。
• 在登录接口用 curl 模拟 SQL 注入：

curl -d "username=admin' or '1'='1&password=1" http://localhost:8080/login

如果这条命令返回登录成功页，说明 SQL 语句用了字符串拼接，属于最容易被一眼看穿的硬伤，必须在答辩前处理。把 Filter、输出编码和参数化查询这三处补齐后，再回头看 DbUtil 的直连代码，你会发现自己已经能把每条连接的生命周期说清楚了。

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