Java Web教学项目Hotelmanger.zip部署与排错指南

简介：本资源是一个基于Java开发的酒店管理系统实战项目，面向Java初学者与课程设计学习者，解决酒店日常运营中房间管理、入住退房、预订调度、收银结算及权限管控等核心业务场景。压缩包为zip格式，大小1.23MB，虽未提供具体文件明细，但结合系统描述可知包含Java源码、数据库脚本（如SQL建表语句）、配置文件及可能的可执行jar或Web应用结构，支撑完整运行与二次开发。已有919人学习下载，反映出其在高校课程实践与Java Web入门项目中的实用热度。读者可直接导入IDE运行调试，掌握Spring Boot或传统Servlet架构下的模块化开发逻辑，理解MVC分层设计、数据库CRUD操作、用户权限控制实现及前后端基础交互流程，是巩固Java基础、衔接真实业务需求的典型教学级工程范例。

1. Hotelmanger.zip 是什么？它不是“酒店管理系统源码包”，而是一个典型 Java Web 工程的压缩快照——适合练手、改需求、跑通流程，但绝不能直接上线

Hotelmanger.zip这个名字在 Java 学习者和课程设计场景中高频出现，它不是某个知名开源项目，也不是商业 SaaS 的官方分发包，而是高校课程设计、Java Web 入门实训、毕业设计选题中广泛流传的一类「教学型酒店管理后台」压缩包。你搜到的绝大多数Hotelmanger.zip，本质是：一个基于 Servlet + JSP + JDBC + MySQL 的单体 Web 应用，JDK 版本多为 8 或 11，Tomcat 7/8/9 可部署，无 Spring Boot、无 Maven、无前端框架，纯手写 HTML 表单 + Java Bean + DAO 层。它解决的是「学生需要交一个能增删改查房间、客户、订单的可运行系统」这个刚需，而不是「高并发酒店预订系统」。所以别被名字误导——它不带分布式事务、不支持微服务拆分、没做 XSS 过滤、密码明文存库是常态。但它极其真实：有 login.jsp 登录页、有 room_list.jsp 列表页、有 addRoomServlet.java 处理逻辑、有 db.properties 配置文件、甚至还有webapps/ROOT/下硬编码的路径。如果你正卡在「Java Web 环境配好了却跑不起来 demo」、「JSP 报 404 不知道缺哪层」、「MySQL 连不上但命令行能登」、「中文乱码调了三小时还是乱」这些具体问题上，这篇笔记就是为你写的——我们不讲理论，只拆包、改配置、跑通、踩坑、验证，每一步都对应你双击解压后看到的真实文件结构。

2. 解压后第一眼该看什么？从文件结构反推技术栈与启动路径

拿到Hotelmanger.zip，别急着导入 IDE。先解压，用资源管理器或unzip -l Hotelmanger.zip看清目录骨架。这类包最常见结构如下（已去重合并多个版本共性）：

Hotelmanger/ ├── WebContent/ ← Tomcat 的 webapp 根目录（老式 Eclipse 动态 Web 项目结构） │ ├── WEB-INF/ │ │ ├── web.xml ← 关键！Servlet 映射、过滤器、欢迎页全在这里 │ │ ├── lib/ ← jar 包存放处（mysql-connector-java.jar 必须有） │ │ └── classes/ ← 编译后的 .class 文件（若 src 未编译，此处为空） │ ├── index.jsp │ ├── login.jsp │ ├── room_list.jsp │ └── css/js/images/ ← 静态资源 ├── src/ ← Java 源码（包结构如 com.hotel.dao, com.hotel.servlet） │ ├── com/hotel/dao/ │ │ └── RoomDao.java │ ├── com/hotel/servlet/ │ │ └── LoginServlet.java │ └── com/hotel/bean/ │ └── Room.java ├── db.properties ← 数据库连接配置（host/port/dbname/user/pass） └── README.txt ← 常见是空的，或写“请导入 hotel.sql”

提示：如果解压后只有src/和lib/，没有WebContent/，说明这是 Maven 项目但被错误打包——需补src/main/webapp/WEB-INF/web.xml并确认pom.xml中<packaging>war</packaging>。但Hotelmanger.zip绝大多数属于前者（传统 Web 项目），我们按此处理。

2.1 重点盯死web.xml：它是整个应用的“路由中枢”

打开WebContent/WEB-INF/web.xml，逐行读，重点关注三类节点：

• <welcome-file-list>：定义根路径/访问时跳转的页面，例如：

  <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list>

  → 浏览器输入http://localhost:8080/就会加载index.jsp，不是login.jsp。

• <servlet>+<servlet-mapping>：定义 Java 类如何响应 URL。典型片段：

  <servlet> <servlet-name>LoginServlet</servlet-name> <servlet-class>com.hotel.servlet.LoginServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>LoginServlet</servlet-name> <url-pattern>/login</url-pattern> </servlet-mapping>

  → 表示访问/login时，由com.hotel.servlet.LoginServlet类处理。注意<servlet-class>的完整包名必须与src/下.java文件的package声明严格一致（大小写敏感！）。

• <context-param>：全局初始化参数，常用于指定数据库配置文件路径：

  <context-param> <param-name>configLocation</param-name> <param-value>/WEB-INF/db.properties</param-value> </context-param>

2.2db.properties是启动前必须校准的“命门”

该文件通常位于WebContent/WEB-INF/或项目根目录，内容类似：

driver=com.mysql.jdbc.Driver url=jdbc:mysql://localhost:3306/hotel?useUnicode=true&characterEncoding=UTF-8 user=root password=123456

关键检查点：

• driver：JDK 8 及以下用com.mysql.jdbc.Driver；JDK 9+ 推荐com.mysql.cj.jdbc.Driver（否则启动报ClassNotFoundException）；
• url：hotel是数据库名，必须提前在 MySQL 中CREATE DATABASE hotel CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;；
• characterEncoding=UTF-8：必须存在，否则中文插入/查询必乱码；
• password：若 MySQL root 密码非空，此处必须填对；若用新用户，需GRANT ALL ON hotel.* TO 'hoteluser'@'localhost' IDENTIFIED BY 'pwd123'; FLUSH PRIVILEGES;。

2.3lib/目录里至少要有这两个 jar

注意：servlet-api.jar是典型的“新手翻车点”。很多教程让初学者把 Tomcat 的lib/servlet-api.jar复制进项目lib/，结果部署时报错。正确做法：Eclipse 中右键项目 → Properties → Targeted Runtimes → 勾选你的 Tomcat Server；IntelliJ 中 File → Project Structure → Modules → Dependencies → 点 “+” → Library → From Maven → 搜索javax.servlet:javax.servlet-api:4.0.1（provided scope）。jar 包只放业务依赖，容器 API 由服务器提供。

3. 在本地 Tomcat 上跑通：从零配置到首页可见的最小闭环

目标：解压Hotelmanger.zip→ 配置好数据库 → 放入 Tomcat → 启动 → 浏览器打开http://localhost:8080/看到首页（哪怕只是文字“欢迎使用酒店管理系统”）。

3.1 Tomcat 版本与 JDK 的硬匹配规则

Hotelmanger.zip多数为老项目，严禁盲目用最新版 Tomcat 和 JDK。匹配原则如下：

实操建议：下载Tomcat 8.5.99（最后稳定版），解压到无中文、无空格路径（如D:\tomcat8），并确保JAVA_HOME指向 JDK 8（java -version输出1.8.0_3XX）。

3.2 部署：不是复制整个文件夹，而是精准放对位置

错误做法：把Hotelmanger/整个文件夹扔进tomcat/webapps/→ Tomcat 会尝试部署为Hotelmanger应用，访问路径变成http://localhost:8080/Hotelmanger/，但web.xml里的<welcome-file>仍指向index.jsp，导致 404。

正确做法（两种，任选其一）：

方案 A：重命名为 ROOT（推荐给新手）

# Windows 命令行（以管理员身份运行） cd D:\tomcat8\webapps rmdir /s /q ROOT xcopy /e /i "D:\download\Hotelmanger\WebContent" "ROOT"

→ 此时WebContent/内容直接成为 Tomcat 根应用，http://localhost:8080/即首页。

方案 B：打包成 WAR 并部署（适合后续迭代）

# 在 Hotelmanger/ 目录下执行（确保当前目录含 WebContent/） jar -cvf Hotelmanger.war -C WebContent/ . # 然后复制 Hotelmanger.war 到 tomcat/webapps/，Tomcat 自动解压

→ 访问http://localhost:8080/Hotelmanger/。

3.3 启动与验证：三步定位失败根源

1. 启动 Tomcat：运行tomcat/bin/startup.bat（Windows）或./startup.sh（Linux），观察控制台是否输出Server startup in [XXX] ms；
2. 检查日志：打开tomcat/logs/catalina.out（Linux）或catalina.yyyy-mm-dd.log（Windows），搜索关键词：
   • SEVERE：严重错误（如数据库连不上、类找不到）；
   • INFO：正常启动信息（如Deploying web application directory [...]）；
   • WARNING：警告（如Unable to find a <welcome-file> in context）；
3. 浏览器验证：
   • 成功：http://localhost:8080/返回 HTML 页面（哪怕样式错乱）；
   • 失败：
     • 404：检查web.xml欢迎页路径、ROOT目录结构、Tomcat 是否真启动；
     • 500：看日志中Caused by:后的异常（如SQLException说明数据库问题，ClassNotFoundException说明 jar 缺失）；
     • 空白页：F12 打开开发者工具 → Console 查 JS 错误，Network 查index.jsp返回状态码。

血泪经验：我曾因WebContent/index.jsp第一行写了<%@ page contentType="text/html;charset=gb2312" %>，而db.properties用了UTF-8，导致登录后所有中文显示为??。最终统一改为<%@ page contentType="text/html;charset=UTF-8" %>并重启 Tomcat 解决。JSP 页面编码、数据库连接编码、Tomcat server.xml URIEncoding 必须三者一致。

4. 数据库初始化与连接排障：为什么 login.jsp 总提示“用户名或密码错误”？

Hotelmanger.zip附带的 SQL 脚本（常见名：hotel.sql、init.sql、database.sql）往往藏在doc/或sql/目录，也可能根本没有——这时你得自己建表。核心四张表结构（精简版，去除非必要字段）：

-- 用户表（登录用） CREATE TABLE users ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, -- 注意：明文存储！仅教学用 role ENUM('admin','staff') DEFAULT 'staff' ); -- 房间表 CREATE TABLE rooms ( id INT PRIMARY KEY AUTO_INCREMENT, room_number VARCHAR(10) NOT NULL UNIQUE, type VARCHAR(20), price DECIMAL(8,2), status ENUM('available','occupied','cleaning') DEFAULT 'available' ); -- 客户表 CREATE TABLE customers ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100), phone VARCHAR(20) ); -- 订单表（关联房间与客户） CREATE TABLE orders ( id INT PRIMARY KEY AUTO_INCREMENT, room_id INT, customer_id INT, check_in DATE, check_out DATE, FOREIGN KEY (room_id) REFERENCES rooms(id), FOREIGN KEY (customer_id) REFERENCES customers(id) );

4.1 插入测试数据：让 login.jsp 至少能过第一关

INSERT INTO users (username, password, role) VALUES ('admin', 'admin123', 'admin'), ('staff1', '123456', 'staff');

→ 这样你在login.jsp输入admin/admin123就能登录。别试root/123456，因为users表里没有这条记录。

4.2 JDBC 连接池？不存在的——但你得手动加 try-catch 防崩

Hotelmanger.zip中的 DAO 类（如UserDao.java）几乎全是直连模式：

public static Connection getConnection() throws SQLException { Properties prop = new Properties(); prop.load(new FileInputStream("WEB-INF/db.properties")); // ⚠️ 路径错误高发区！ String url = prop.getProperty("url"); String user = prop.getProperty("user"); String pwd = prop.getProperty("password"); return DriverManager.getConnection(url, user, pwd); // ⚠️ 无连接池，高并发必挂 }

问题在于new FileInputStream("WEB-INF/db.properties")—— 这个路径在 Tomcat 中是错的！正确路径应为：

// 替换原代码中的 FileInputStream 行： InputStream is = Hotelmanger.class.getClassLoader().getResourceAsStream("db.properties"); // 或更稳妥（从 ServletContext 获取）： ServletContext context = getServletContext(); // 在 Servlet 中 InputStream is = context.getResourceAsStream("/WEB-INF/db.properties");

但教学项目通常不改，所以最简单方案：把db.properties复制到WebContent/WEB-INF/classes/目录下，这样ClassLoader.getResourceAsStream("db.properties")就能加载到。

4.3 中文乱码的终极排查清单（按优先级）

玄学时刻：有时改完所有编码，重启 Tomcat 还是乱码。我的后悔药是——删掉tomcat/work/Catalina/localhost/下所有文件，清空tomcat/temp/，再重启。Tomcat 的 JSP 编译缓存（.java和.class）会固守旧编码。

5. 避坑：五个让 90% 新手卡三天的真实问题与解法

5.1 现象：启动 Tomcat 后，http://localhost:8080/显示 404，但http://localhost:8080/manager/html能进 Tomcat Manager

原因：Hotelmanger.zip未正确部署为 ROOT 应用，或WebContent/内缺少index.jsp（有些版本用login.jsp作首页，但web.xml没配欢迎页）。
解决：

1. 确认tomcat/webapps/ROOT/目录下有index.jsp；
2. 检查web.xml中<welcome-file-list>是否包含index.jsp；
3. 若只有login.jsp，则修改<welcome-file>login.jsp</welcome-file>，或直接在浏览器访问http://localhost:8080/login.jsp。

5.2 现象：点击登录按钮，页面跳转到http://localhost:8080/login，报 404

原因：web.xml中<servlet-mapping>的<url-pattern>与表单action不一致。常见错误：

• login.jsp中<form action="login" method="post">
• 但web.xml里<url-pattern>/login.do</url-pattern>（多了.do）
  解决：

1. 打开login.jsp，找到<form>标签，将action改为action="login"；
2. 或打开web.xml，将<url-pattern>改为<url-pattern>/login</url-pattern>；
3. 二者必须完全一致（包括斜杠、后缀）。

5.3 现象：登录成功后跳转到room_list.jsp，但页面空白，查看源码发现<%=room.getRoomNumber()%>输出null

原因：Room实体类的 getter 方法命名不规范，或 JSP 中 EL 表达式未启用。
解决：

1. 检查Room.java是否有public String getRoomNumber() { return roomNumber; }（首字母大写）；
2. 确认room_list.jsp顶部有<%@ page isELIgnored="false" %>（Tomcat 8+ 默认开启，但老项目可能关了）；
3. 在web.xml中确认<web-app>根标签有version="3.0"或更高（EL 3.0+ 支持方法调用）。

5.4 现象：room_list.jsp显示“查询不到房间”，但 MySQL 中rooms表明明有数据

原因：DAO 层 SQL 查询语句写错，或ResultSet字段名与实体类属性名不匹配。
解决：

1. 在RoomDao.java的查询方法中，rs.getString("room_number")→ 但数据库字段是roomNumber（驼峰）或roomnumber（全小写）；
2. 最佳实践：用rs.getString("room_number")（下划线）或rs.getString("roomNumber")（驼峰），但必须与数据库字段名完全一致（区分大小写！Linux 下 MySQL 默认区分）；
3. 加日志：在 DAO 方法中System.out.println("SQL: " + sql);，复制到 MySQL 命令行执行，看是否返回数据。

5.5 现象：修改LoginServlet.java后，重启 Tomcat，页面行为没变

原因：Tomcat 没重新编译 class，或 IDE 没把 class 文件输出到WEB-INF/classes/。
解决：

1. 删除tomcat/webapps/ROOT/WEB-INF/classes/com/hotel/servlet/LoginServlet.class；
2. 手动编译：javac -encoding UTF-8 -cp "D:\tomcat8\lib\servlet-api.jar;D:\tomcat8\webapps\ROOT\WEB-INF\lib\mysql-connector-java-5.1.47.jar" -d "D:\tomcat8\webapps\ROOT\WEB-INF\classes" "src\com\hotel\servlet\LoginServlet.java"；
3. 或用 IDE：Eclipse 中右键项目 → Refresh；IntelliJ 中 Build → Build Project。

6. 从教学项目到可用系统的三步改造：加登录拦截、修 SQL 注入、换数据库驱动

Hotelmanger.zip的价值不在“能跑”，而在“能改”。下面这三个改造，每个都能让你在面试时说出“我优化过酒店系统”，且代码改动可控、效果立竿见影。

6.1 加登录拦截器：防止未登录直接访问 room_list.jsp

现状：room_list.jsp可被直接 URL 访问，绕过登录。
改造思路：用Filter拦截所有/jsp/*请求，检查 session 中是否有user。

步骤：

1. 创建com.hotel.filter.LoginFilter.java：

package com.hotel.filter; import javax.servlet.*; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.HttpSession; import java.io.IOException; public class LoginFilter implements Filter { @Override public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request = (HttpServletRequest) req; HttpServletResponse response = (HttpServletResponse) resp; HttpSession session = request.getSession(false); String uri = request.getRequestURI(); // 放行登录页、登录动作、静态资源 if (uri.contains("/login.jsp") || uri.contains("/LoginServlet") || uri.contains("/css/") || uri.contains("/js/") || uri.contains("/images/")) { chain.doFilter(req, resp); return; } // 检查登录态 if (session == null || session.getAttribute("user") == null) { response.sendRedirect(request.getContextPath() + "/login.jsp"); return; } chain.doFilter(req, resp); } }

2. 在web.xml中注册：

<filter> <filter-name>LoginFilter</filter-name> <filter-class>com.hotel.filter.LoginFilter</filter-class> </filter> <filter-mapping> <filter-name>LoginFilter</filter-name> <url-pattern>/jsp/*</url-pattern> <!-- 假设 jsp 放在 WebContent/jsp/ 下 --> </filter-mapping>

3. 将room_list.jsp移到WebContent/jsp/room_list.jsp，并修改所有跳转链接为/jsp/room_list.jsp。

效果：直接访问http://localhost:8080/jsp/room_list.jsp会自动跳回login.jsp。这是 Java Web 安全的第一道门槛，比“背八股文”实在得多。

6.2 修 SQL 注入：把Statement换成PreparedStatement

现状：UserDao.java中常见写法：

String sql = "SELECT * FROM users WHERE username='" + username + "' AND password='" + password + "'"; Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery(sql); // ⚠️ 危险！' OR '1'='1 可绕过登录

改造：

String sql = "SELECT * FROM users WHERE username=? AND password=?"; PreparedStatement pstmt = conn.prepareStatement(sql); pstmt.setString(1, username); // 参数索引从 1 开始 pstmt.setString(2, password); ResultSet rs = pstmt.executeQuery();

→ 仅此一行改，就堵住经典注入漏洞。面试官问“怎么防 SQL 注入”，你就能指着这段代码说：“用 PreparedStatement 预编译，参数化查询”。

6.3 换 MySQL 驱动：适配 JDK 11+ 与 MySQL 8+

现状：lib/mysql-connector-java-5.1.47.jar在 JDK 11+ 上报java.lang.ClassNotFoundException: com.mysql.jdbc.Driver。
改造：

1. 下载mysql-connector-java-8.0.28.jar（官网或 Maven Repository）；
2. 替换WebContent/WEB-INF/lib/下旧 jar；
3. 修改db.properties：

driver=com.mysql.cj.jdbc.Driver url=jdbc:mysql://localhost:3306/hotel?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai

→serverTimezone=Asia/Shanghai解决时区报错（MySQL 8 默认 UTC，Java 读时间戳会差 8 小时）。

我的习惯：每次拿到Hotelmanger.zip，第一件事就是删掉lib/下所有 jar，只留mysql-connector-java-8.0.28.jar和servlet-api.jar（不放！），然后按上述三步改。三个小时，一个教学项目就具备了基础安全、现代驱动、会话管控——这比背一百道“Java 有哪些集合类”有用得多。希望帮到你。

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