简介：这是一套面向计算机专业学生与Java Web入门者的酒店客房预定管理系统实战项目，采用Servlet与JSP技术栈，配合Tomcat服务器和MySQL数据库，分为前台用户端与后台管理端，可直接作为毕业设计或课程设计参考。压缩包共170个文件，约1.21MB，其中41个Java源文件与41个class文件构成核心业务逻辑，34个JSP页面负责视图展示，另有gif、jpg等图片素材、jar依赖包、xml配置及一份sql数据库脚本，结构完整、层次清晰。功能上，用户端支持注册登录、预约房间、客房搜索、在线留言与预定记录查询；管理端涵盖客房及分类管理、会员管理、留言管理、剩余房间与订房信息查询，覆盖酒店预订的主要业务流程。项目经过严格调试，导入后即可运行，适合需要完整项目实战练习或毕设参考的学习者。目前已有340人学习，可作为理解Servlet请求处理、JSP页面交互与数据库操作的实践样本。
1. 从一份编译好的 class 文件说起：这个酒店预定系统到底能不能跑起来
很多人拿到一个 JavaWeb 项目压缩包，第一反应是翻源码，结果发现里面躺着一堆.class文件——SmartUpload.class、ListServlet.class、AddHotelServlet.class、ShoppingServlet.class、LoanHotelServlet.class、PwdNameUserServlet.class、DelServlet.class、UpdateHostelServlet.class、ModifyUserServlet.class。这不是源码丢失，而是典型的「编译产物 + 源码混合」打包方式，说明作者是在 Eclipse 或 IDEA 里编译完之后直接导出的。这套基于 Servlet + JSP 的酒店客房预定管理系统，分前后台两条线：前台给用户注册登录、搜房、预约、留言、查预定记录；后台给管理员管客房、管分类、管会员、管留言、查剩余房间和订房信息。技术栈就是最经典的 Tomcat + MySQL + Servlet/JSP 组合，没有 Spring、没有 MyBatis，纯原生写法。它适合两类人：一是正在做毕业设计、需要一个能跑通、结构清晰、方便改的 JavaWeb 底稿的学生；二是想拿一个完整 CRUD 项目练手、把 Servlet 生命周期和 JSP 页面交互彻底搞明白的初学者。下面我按「怎么把它跑起来 → 每个模块怎么改 → 哪里容易翻车 → 怎么验证改对了」的顺序拆一遍。
2. 把项目跑起来：Tomcat 版本、MySQL 连接与 class 文件反编译
2.1 环境对齐：Tomcat 7+ 与 MySQL 5.0+ 的兼容边界
这套项目对版本不挑，但有几个硬性边界必须卡住。Tomcat 7 及以上都能跑，因为 Servlet 3.0 规范从 Tomcat 7 开始支持注解配置，项目里如果用了@WebServlet就不用改web.xml；但如果你的 Tomcat 是 10 以上，包名已经从javax.servlet变成jakarta.servlet，直接部署会报ClassNotFoundException，这是第一个大坑。MySQL 5.0 及以上都行，但 8.0 之后驱动类名从com.mysql.jdbc.Driver变成com.mysql.cj.jdbc.Driver，连接 URL 还要加时区和 SSL 参数。我一般会先把环境锁在 Tomcat 8.5 + MySQL 5.7 + JDK 8，这个组合最稳，不会因为版本差异浪费一整天。
数据库脚本导入用 Navicat 最省事：新建一个库，字符集选utf8mb4，然后运行项目里的.sql文件。导入完检查两张核心表——hotel（客房信息）和order（预定记录），确认字段类型和主键自增都正常。如果脚本里用了order这种关键字做表名，MySQL 会报语法错误，需要在表名两边加反引号，这是第二个容易忽略的点。
2.2 反编译 class 文件：把 SmartUpload 和各个 Servlet 还原成可读源码
项目里那些.class文件不是摆设，它们是理解业务逻辑的钥匙。SmartUpload.class 和 SmartFile.class 是文件上传组件，负责客房图片上传；ListServlet、AddHotelServlet、ShoppingServlet、LoanHotelServlet、PwdNameUserServlet、DelServlet、UpdateHostelServlet、ModifyUserServlet 分别对应列表查询、添加客房、购物车/预约、借出/归还逻辑、用户密码修改、删除、更新客房、修改用户信息。如果你只有 class 没有 java，用 JD-GUI 或 CFR 反编译就能还原出八成以上的逻辑。
# 用 CFR 反编译单个 class 文件，输出到当前目录 java -jar cfr.jar SmartUpload.class # 批量反编译整个 classes 目录 java -jar cfr.jar ./WEB-INF/classes/ --outputdir ./src_decompiled反编译出来的代码变量名可能是arg0、var1这种，但方法调用和 SQL 语句是完整的。重点看每个 Servlet 的doPost方法里怎么拿request.getParameter，以及怎么拼 SQL。比如AddHotelServlet里大概率是拿客房名称、价格、图片路径，然后insert into hotel(...) values(...)。参数说明：cfr.jar的--outputdir指定输出目录，不加就输出到当前目录；如果 class 文件有内部类，CFR 会自动生成XXX$1.class对应的 java 文件。
2.3 部署到 Tomcat 并验证首页能打开
把项目文件夹整个丢进webapps目录，或者用 Eclipse 的 Server 视图添加 Tomcat 后右键 Run on Server。启动后访问http://localhost:8080/项目名/，如果首页是index.jsp或login.jsp，能正常渲染就说明 JSP 编译没问题。如果报 404，先检查web.xml里的welcome-file-list配置；如果报 500 且堆栈指向数据库，就去WEB-INF/classes下找db.properties或直接看 Servlet 里的硬编码连接串，把用户名密码改成你本地的。
// 常见硬编码连接写法，反编译后大概率长这样 String url = "jdbc:mysql://localhost:3306/hotel_db?useUnicode=true&characterEncoding=utf8"; String user = "root"; String password = "123456"; Class.forName("com.mysql.jdbc.Driver"); Connection conn = DriverManager.getConnection(url, user, password);逻辑说明：Class.forName加载驱动，MySQL 8 要换成com.mysql.cj.jdbc.Driver；URL 里的characterEncoding=utf8防止中文乱码，如果数据库是 8.0 还要加serverTimezone=Asia/Shanghai&useSSL=false。参数怎么改：库名hotel_db换成你实际建的库名，密码换成你本地 MySQL 的密码。这一步跑通，后面改功能才有意义。
3. 前台模块怎么改：注册登录、客房搜索与预约流程的 Servlet 链路
3.1 用户注册登录：PwdNameUserServlet 的参数校验与 SQL 注入防护
前台用户注册和登录大概率都走PwdNameUserServlet，通过一个action参数区分是register还是login。反编译后你会看到类似if("register".equals(action)){...}的分支。注册逻辑一般是先查用户名是否存在，再插入；登录就是select * from user where username=? and password=?。这里有个血泪经验：如果原代码用的是字符串拼接 SQL，比如"select * from user where username='" + name + "'"，那就存在 SQL 注入风险，输入' or '1'='1就能绕过登录。改法是换成PreparedStatement。
// 改造前：拼接 SQL，有注入风险 String sql = "select * from user where username='" + username + "' and password='" + password + "'"; Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery(sql); // 改造后：PreparedStatement 预编译，参数用占位符 String sql = "select * from user where username=? and password=?"; PreparedStatement ps = conn.prepareStatement(sql); ps.setString(1, username); ps.setString(2, password); ResultSet rs = ps.executeQuery();逻辑说明：?是占位符，setString(1, username)把第一个问号替换成实际参数，驱动会自动转义特殊字符。参数说明：索引从 1 开始，不是 0；如果参数是 int 就用setInt。改完登录逻辑后，用' or '1'='1再试一次，如果提示用户名或密码错误，说明防护生效了。
3.2 客房搜索与预约：ShoppingServlet 和 LoanHotelServlet 的协作
客房搜索一般走ListServlet，根据关键词、价格区间、分类 ID 动态拼where条件。预约流程则涉及ShoppingServlet（加入预定车）和LoanHotelServlet（确认预定/借出）。这里的关键是理解「剩余房间」怎么扣减：用户下单时，hotel表的stock或remain字段要减 1，同时往order表插一条记录。如果原代码没有事务控制，并发下单会出现超卖。常见做法是在LoanHotelServlet里手动开事务：
Connection conn = null; try { conn = DriverManager.getConnection(url, user, password); conn.setAutoCommit(false); // 关闭自动提交 // 1. 扣减库存 String sql1 = "update hotel set stock = stock - 1 where id = ? and stock > 0"; PreparedStatement ps1 = conn.prepareStatement(sql1); ps1.setInt(1, hotelId); int rows = ps1.executeUpdate(); if (rows == 0) throw new RuntimeException("库存不足"); // 2. 插入订单 String sql2 = "insert into `order`(user_id, hotel_id, create_time) values(?,?,now())"; PreparedStatement ps2 = conn.prepareStatement(sql2); ps2.setInt(1, userId); ps2.setInt(2, hotelId); ps2.executeUpdate(); conn.commit(); // 两步都成功才提交 } catch (Exception e) { if (conn != null) conn.rollback(); // 任一步失败就回滚 e.printStackTrace(); } finally { if (conn != null) conn.close(); }逻辑说明：setAutoCommit(false)开启事务，commit()提交，rollback()回滚。参数说明：stock > 0是乐观锁思路，防止扣成负数；now()是 MySQL 函数，取当前时间。改完用两个浏览器同时下单同一间房，看是否只有一个成功，另一个提示库存不足。
3.3 在线留言与预定记录：ListServlet 的分页查询改造
在线留言和预定记录查询通常共用ListServlet，通过type参数区分查留言还是查订单。原代码大概率是一次性select *全查出来，数据一多页面就卡。我一般会加limit分页：
-- 第 pageNo 页，每页 pageSize 条 select * from message order by create_time desc limit ?, ?int pageNo = Integer.parseInt(request.getParameter("pageNo") == null ? "1" : request.getParameter("pageNo")); int pageSize = 10; int offset = (pageNo - 1) * pageSize; PreparedStatement ps = conn.prepareStatement("select * from message order by create_time desc limit ?, ?"); ps.setInt(1, offset); ps.setInt(2, pageSize);逻辑说明：offset是跳过的行数，pageSize是每页条数。参数说明：pageNo从 1 开始，前端传参时要做空值判断。改完在留言列表底部加「上一页/下一页」链接，传pageNo参数即可。
4. 后台管理模块怎么改：客房 CRUD、会员管理与剩余房间查询
4.1 客房管理与分类管理：AddHotelServlet 和 UpdateHostelServlet 的字段映射
后台添加客房走AddHotelServlet，更新走UpdateHostelServlet，删除走DelServlet。这三个 Servlet 的套路基本一致：拿参数、拼 SQL、跳转回列表页。重点在字段映射——hotel表里可能有id、name、price、type_id、img_url、stock、description这些列，前端表单的name属性必须和request.getParameter里的名字一一对应。常见翻车是图片上传：SmartUpload组件负责把文件写到服务器磁盘，然后把相对路径存进img_url。如果上传后图片不显示，先检查SmartUpload的save()路径是不是写到了webapps之外。
// SmartUpload 上传核心步骤 SmartUpload su = new SmartUpload(); su.initialize(pageContext); // 初始化，pageContext 是 JSP 内置对象 su.setAllowedFilesList("jpg,png,gif"); // 允许的扩展名 su.setMaxFileSize(5 * 1024 * 1024); // 最大 5MB su.upload(); // 执行上传 String fileName = "upload/" + System.currentTimeMillis() + ".jpg"; su.save(fileName); // 保存到 web 根目录下的 upload 文件夹 String imgUrl = fileName; // 存库逻辑说明：initialize必须传pageContext，所以这段代码通常写在 JSP 里或从 JSP 传pageContext进 Servlet。参数说明：setAllowedFilesList限制扩展名，setMaxFileSize单位是字节。改完上传一张图，去webapps/项目名/upload/下看文件在不在，再查数据库img_url字段是否写入了相对路径。
4.2 会员管理与留言管理：ModifyUserServlet 和 DelServlet 的权限校验
后台的会员管理和留言管理，本质是对user表和message表的增删改查。ModifyUserServlet负责改用户信息，DelServlet负责删记录。这里有个容易被忽略的点：后台操作必须校验管理员是否登录，否则任何人直接访问/ModifyUserServlet?id=1就能改数据。常见做法是在每个后台 Servlet 开头加：
HttpSession session = request.getSession(); Object admin = session.getAttribute("admin"); if (admin == null) { response.sendRedirect("login.jsp"); return; }逻辑说明：session.getAttribute("admin")拿登录时存的管理员对象，为空就跳回登录页。参数说明：sendRedirect后必须return，否则后面的代码还会执行。改完用未登录的浏览器直接访问后台 Servlet 路径，看是否被踢回登录页。
4.3 剩余房间查询与订房信息查询：多表关联 SQL 的写法
剩余房间查询一般查hotel表的stock字段，订房信息查询要关联order、user、hotel三张表。原代码可能用了子查询或多次查询，我一般改成left join一次拿全：
select o.id, u.username, h.name as hotel_name, o.create_time from `order` o left join user u on o.user_id = u.id left join hotel h on o.hotel_id = h.id order by o.create_time desc;逻辑说明：left join保证订单表为主，用户或客房被删了也能查出订单记录。参数说明：as hotel_name是别名，防止name字段冲突。改完在后台订房信息页看是否显示了用户名和客房名，而不是只显示 ID。
5. 避坑与排查：class 文件缺失、中文乱码与 404 的常见原因
5.1 现象：启动报 ClassNotFoundException: SmartUpload
原因：SmartUpload.class和SmartFile.class没有放在WEB-INF/classes对应包路径下，或者web.xml里没配servlet-class。解决：确认 class 文件的包名和目录结构一致，比如com.jspsmart.upload.SmartUpload就要放在WEB-INF/classes/com/jspsmart/upload/下。如果用的是 IDE，把 class 文件拖进src对应包，让 IDE 重新编译输出。
5.2 现象：页面中文显示问号或乱码
原因：JSP 页面pageEncoding和数据库characterEncoding不一致，或者 Servlet 输出前没设response.setContentType。解决：JSP 头部统一写<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>；Servlet 里在getWriter()之前加response.setContentType("text/html;charset=UTF-8")；数据库连接 URL 加characterEncoding=utf8；建库时选utf8mb4。
5.3 现象：访问某个 Servlet 报 404
原因：web.xml里的url-pattern和实际访问路径不匹配，或者用了@WebServlet注解但 Tomcat 版本低于 7。解决：检查web.xml中<servlet-mapping>的<url-pattern>是不是/ListServlet这种带斜杠的写法；如果用注解，确认 Tomcat 是 7 以上。另外注意项目部署路径，http://localhost:8080/项目名/ListServlet里的项目名不能少。
5.4 现象：预约后库存没减，或减了但订单没生成
原因：没有事务控制，扣库存和插订单两步只成功了一步。解决：按 3.2 节的写法加setAutoCommit(false)和commit/rollback。另外检查update语句的where条件是否带了stock > 0，否则并发时会扣成负数。
5.5 现象：图片上传成功但页面不显示
原因：SmartUpload.save()的路径是相对于当前 JSP 的，不是相对于项目根目录。解决：统一用su.save("/upload/" + fileName)，开头的斜杠表示从 web 根目录开始。存库时也只存/upload/xxx.jpg，前端<img src="${pageContext.request.contextPath}/upload/xxx.jpg">这样拼绝对路径。
6. 进阶技巧：用反编译结果反推数据库设计并做二次开发
反编译完所有 class 之后，我习惯做一件事：把每个 Servlet 里出现的 SQL 语句全部摘出来，按表名归类，反推出完整的数据库 ER 关系。比如AddHotelServlet里出现insert into hotel，ListServlet里出现select * from hotel，DelServlet里出现delete from hotel where id=?，那hotel表的字段就能从setString、setInt的索引和参数名猜个八九不离十。这个方法比直接看.sql脚本还准，因为脚本可能是旧的，而 class 是编译时最新的。
// 从反编译代码里提取 SQL 的笨办法：全局搜索关键词 // 在 JD-GUI 里 Ctrl+F 搜 "select"、"insert"、"update"、"delete" // 把每条 SQL 复制到文本文件，按表名分组 // 例如： // hotel: insert into hotel(name,price,type_id,img_url,stock) values(?,?,?,?,?) // hotel: select * from hotel where type_id=? order by id desc // order: insert into `order`(user_id,hotel_id,create_time) values(?,?,now()) // user: select * from user where username=? and password=?逻辑说明：通过 SQL 反推字段名和类型，再对照数据库实际表结构，能发现哪些字段是废弃的、哪些是后加的。参数说明：?的个数就是字段数，setString的索引对应字段顺序。我一般会画一张简单的表关系图，标出主外键，然后决定二次开发时是加字段还是加表。
二次开发最常见的需求是加一个「客房评价」功能。基于现有结构，我会新建comment表，字段包括id、user_id、hotel_id、content、create_time，然后仿照AddHotelServlet写一个AddCommentServlet，仿照ListServlet写一个ListCommentServlet，前端在客房详情页加一个表单。因为原项目是纯 Servlet + JSP，没有框架的依赖注入和 AOP，所有逻辑都要手写，但好处是改起来直观，不用理解复杂配置。
验证二次开发是否成功，我习惯走一遍完整链路：注册新用户 → 登录 → 搜房 → 下单 → 后台确认订单 → 用户留言 → 后台回复留言 → 删除测试数据。每一步都看数据库对应表的变化，确保没有脏数据。从那以后我每次拿到这种 class 和源码混合的项目，都强制先反编译、再跑通主流程、最后才动手改功能，不然很容易在环境问题上耗掉半天。希望帮到你。
本文还有配套的精品资源，点击获取
