简介一套基于SSMSpringSpringMVCMyBatis与MySQL的酒店客房预定管理系统完整项目面向毕业设计、课程设计及需要快速掌握Java Web开发流程的初学者。系统覆盖个人中心、用户管理、客房类型管理、客房预定、开房记录、退房结账、系统管理等模块业务流程完整具备权限分级与基础报表统计能力。压缩包共含1254个文件以java源码、jsp页面、js脚本、css样式及png/gif图片资源为主另含sql数据库脚本、xml配置文件、设计文档、部署说明和视频演示整体约18.9MB。资源已经过测试校正可百分百运行帮助读者省去环境搭建和排错时间直接对照学习SSM整合思路与酒店管理业务实现。目前已有185人学习下载适合作为实战练手或毕业设计参考。1. 基于SSMMySQL的酒店客房预定管理系统毕业设计项目的核心技术拆解做毕设选项目最怕的不是功能少而是源码拿到手跑不起来。这套基于SSM框架SpringSpringMVCMyBatis的酒店客房预定管理系统属于典型的Java Web课程设计/毕业设计项目——Spring管理业务对象SpringMVC接收请求MyBatis操作MySQL数据库前端用JSP渲染页面配了Bootstrap和ElementUI做界面样式。项目源码经过测试校正附带完整设计文档和部署说明适合需要快速交付的从业者不管是做毕业设计还是课程设计拿到就能跑通省去从零搭框架的时间。接下来按实际拆解路径走先讲SSM架构和数据库设计再拆核心业务代码最后落到部署和排错。2. SSM三层架构与MySQL表设计从配置链路到九张核心表2.1 为什么选SSM框架三层架构的职责边界SSM是老牌组合Spring负责Bean管理SpringMVC负责Web层请求分发MyBatis负责数据持久化。它的核心优势在于职责边界清晰控制层Controller只做参数接收和视图跳转业务层Service只处理业务逻辑数据层Mapper只做SQL映射。这种分层方式特别适合酒店客房预定这种业务模型相对固定的系统每张表的增删改查都能对应到Mapper接口扩展新功能时不会牵一发动全身。对比Spring Boot的单体服务风格SSM虽然配置繁琐但每个配置文件都是显式声明适合理解Java Web的请求流转过程。常见做法是Spring负责Service层Bean管理SpringMVC负责Controller层MyBatis负责Mapper层与数据库的连接管理。这个系统里三者协作路径是浏览器请求 → DispatcherServlet → Controller → Service → Mapper → MySQL返回路径反向走最终由视图解析器渲染JSP页面。2.2 数据库表设计预定、开房、退房三张业务表的状态关联从项目源码里的实体类可以反推出表结构。系统核心角色分管理员和普通用户围绕客房产生预定、开房、退房三条业务链路。表的设计遵循第三范式把用户表、客房表、类型表拆分独立通过外键关联。需要重点理解的是预定、开房记录、退房结账三张表的关系预定表存客户预定意向开房记录表存实际入住信息退房结账表算费用。这三张表通过客房ID和用户ID串联起来。-- 客房类型表 CREATE TABLE room_type ( id INT PRIMARY KEY AUTO_INCREMENT, type_name VARCHAR(50) NOT NULL COMMENT 类型名称如标准间/大床房, price DECIMAL(10,2) NOT NULL COMMENT 单价按晚计价, remark VARCHAR(255) COMMENT 备注 ) ENGINEInnoDB DEFAULT CHARSETutf8; -- 酒店客房表 CREATE TABLE hotel_room ( id INT PRIMARY KEY AUTO_INCREMENT, room_no VARCHAR(20) NOT NULL COMMENT 房号如8801, room_type_id INT NOT NULL COMMENT 外键客房类型ID, status TINYINT DEFAULT 0 COMMENT 状态0空闲 1已预定 2已入住, floor INT COMMENT 楼层, FOREIGN KEY (room_type_id) REFERENCES room_type(id) ) ENGINEInnoDB DEFAULT CHARSETutf8; -- 客房预定表 CREATE TABLE room_order ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL COMMENT 外键预定客户ID, room_id INT NOT NULL COMMENT 外键客房ID, order_no VARCHAR(32) NOT NULL COMMENT 预定单号, check_in_date DATE NOT NULL COMMENT 计划入住日期, check_out_date DATE NOT NULL COMMENT 计划退房日期, order_status TINYINT DEFAULT 0 COMMENT 预定状态0有效 1已取消 2已入住, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (user_id) REFERENCES sys_user(id), FOREIGN KEY (room_id) REFERENCES hotel_room(id) ) ENGINEInnoDB DEFAULT CHARSETutf8;参数说明room_type_id设置外键约束保证客房必须归属一个有效类型status用TINYINT存状态码而不是字符串查询效率更高后续加状态只需扩展数字含义。room_order表里order_no用32位VARCHAR存唯一单号方便订单追踪实际项目里单号一般用时间戳加随机数拼接生成。check_in_date和check_out_date用DATE类型避免DATETIME带来的时分秒干扰日期间隔计算直接做日期减法即可。这里有个设计细节值得注意预定表和开房记录表没有合并成一张表。刚开始做容易犯的错是把预定、入住、退房全塞进一张订单表用状态字段区分。拆开的好处是——预定是客户行为可能有取消操作开房记录是酒店行为涉及房间分配和押金退房结账是财务行为涉及实收金额。三张表各自记录生命周期报表统计时用JOIN关联即可。2.3 配置文件链路web.xml、spring-mvc.xml、mybatis-config.xml的协作方式SSM项目最容易翻车的地方在配置文件这个项目从源码里能看到完整的配置链。web.xml负责启动Spring容器和SpringMVC前端控制器spring-mvc.xml负责扫描Controller和配置视图解析器applicationContext.xml扫描Service和Mappermybatis-config.xml配置MyBatis全局参数。配置文件之间通过contextConfigLocation和classpath引用串联。!-- web.xml 核心片段 -- context-param param-namecontextConfigLocation/param-name param-valueclasspath:applicationContext.xml/param-value /context-param listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener servlet servlet-namespringmvc/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namespringmvc/servlet-name url-pattern//url-pattern /servlet-mapping!-- spring-mvc.xml 核心配置 -- context:component-scan base-packagecom.hotel.controller/ bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/views// property namesuffix value.jsp/ /bean逻辑说明web.xml里DispatcherServlet拦截/路径所有请求进入SpringMVC前端控制器spring-mvc.xml只扫描controller包避免把Service层重复纳入Web容器管理。视图解析器配置prefix和suffix后Controller返回字符串room/list会自动拼接成/WEB-INF/views/room/list.jsp。这种配置方式下JSP页面放在WEB-INF目录里用户不能直接通过URL访问强制走Controller安全性更好。MyBatis部分的配置核心在mapper.xml里系统源码里每张表对应一个Mapper接口加一个XML文件比如RoomMapper.xml里写SQLRoomMapper.java里定义方法。项目里SQL写法和MyBatis-Plus不同更接近原生SQL适合理解数据访问层的工作原理。3. 核心业务实现登录鉴权、客房预定与退房结算的代码拆解3.1 登录鉴权拦截器与Session的角色权限控制用户权限管理在系统里通过SpringMVC拦截器实现分管理员和普通用户两种角色。拦截器统一处理Session校验避免每个Controller重复写判断逻辑。项目里的登录流程是前端表单提交用户名密码Controller调用UserService查询MySQL密码匹配后把用户信息放入Session跳转对应首页。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object user session.getAttribute(loginUser); if (user null) { // 未登录重定向到登录页 response.sendRedirect(request.getContextPath() /login); return false; } // 管理员路径校验要求session中的role字段为1 String uri request.getRequestURI(); if (uri.contains(/admin/)) { Object role session.getAttribute(userRole); if (role null || !1.equals(role.toString())) { response.sendRedirect(request.getContextPath() /index); return false; } } return true; } }参数说明preHandle返回false表示请求被拦截不再进入Controller。userRole字段在登录成功后写入Session值为1代表管理员0代表普通用户。这里做的是一个粗粒度权限控制——限制普通用户不能访问/admin/前缀的路径细粒度的按钮级权限在JSP用c:if标签判断。实际开发中如果权限层级复杂建议引入角色表、菜单表、角色菜单关联表但在这个规模的项目里Session存角色字段足够了改动成本低。3.2 客房预定业务状态机流转与并发控制客房预定是整个系统的核心业务涉及客房状态变更、订单生成、类型价格读取三个动作。系统把预定定义为客户选客房、填入住日期、生成订单、修改客房status为1已预定。这里有前后端联动的逻辑前端通过Ajax传参数Controller接收后开始事务。一个容易被忽略的点是状态判断预定前必须确认客房status是0空闲否则不能下单。Transactional public boolean createOrder(RoomOrder order, Integer roomId) { // 1. 锁定客房并检查状态 HotelRoom room roomMapper.selectByIdForUpdate(roomId); if (room null || room.getStatus() ! 0) { throw new RuntimeException(客房不存在或不可预定); } // 2. 生成订单号时间戳 随机数 String orderNo generateOrderNo(); order.setOrderNo(orderNo); order.setOrderStatus(0); // 3. 更新客房状态为已预定 int update roomMapper.updateStatus(roomId, 1); if (update ! 1) { throw new RuntimeException(客房状态更新失败); } // 4. 保存订单 return orderMapper.insert(order) 0; }参数说明Transactional保证三个阶段要么全部成功要么全部回滚。selectByIdForUpdate是悲观锁写法MySQL执行SELECT ... FOR UPDATE锁定该行直到事务结束防止两个用户同时预定同一间客房。generateOrderNo里常见做法是System.currentTimeMillis()加三位随机数拼成32位字符串保证并发下不重复。这种用锁保证一致性的方案适合小规模系统缺点是并发量上去后锁竞争明显但毕设项目这个量级完全够用。预定状态流转的完整链路是空闲0→ 已预定1→ 已入住2→ 空闲0。用户取消预定状态从1回到0用户办理入住状态从1变2退房结账后状态从2回到0。这个状态机在Service层通过if判断控制没有引入状态机框架逻辑直观便于维护。3.3 开房记录与退房结账金额计算的边界条件开房记录和退房结账是两个紧邻的操作开房时把预定订单状态改为已入住同时创建一条开房记录退房时根据入住天数和客房类型单价计算总费用生成结账记录。金额计算最大的坑在跨天计算——早上6点入住和下午6点入住退房时的计费方式不同这个逻辑在源码里的实现方式是查入住时间按自然日差值计算。public BigDecimal settleAccounts(Integer recordId) { // 1. 查询开房记录拿到入住时间和退房时间 CheckInRecord record checkInRecordMapper.selectById(recordId); // 2. 计算入住天数按日历日计算不足一天按一天计 int days calculateDays(record.getCheckInTime(), record.getCheckOutTime()); // 3. 读取客房类型单价 RoomType roomType roomTypeMapper.selectById(record.getRoomTypeId()); BigDecimal total roomType.getPrice().multiply(BigDecimal.valueOf(days)); // 4. 生成退房结账记录 CheckoutRecord checkout new CheckoutRecord(); checkout.setRecordId(recordId); checkout.setTotalAmount(total); checkout.setCreateTime(new Date()); return checkoutRecordMapper.insert(checkout) 0 ? total : null; } private int calculateDays(Date in, Date out) { long diffMs out.getTime() - in.getTime(); long diffDays diffMs / (1000 * 60 * 60 * 24); long remainder diffMs % (1000 * 60 * 60 * 24); return remainder 0 ? (int) diffDays 1 : (int) diffDays; }参数说明BigDecimal用于金额计算避免double精度丢失——这是财务相关的硬性要求总价计算不能出现0.999999这种结果。calculateDays用毫秒差值取整余数大于0就加一天模拟的是住了3小时也算一天的酒店规则。这个方法是退房结账最容易出bug的地方很多毕设项目在这里直接做天数减法没考虑时分秒带来的误差导致结账金额和预期不符。如果项目需要升级推荐把计费规则做进数据库配置表比如设置一个cutoffTime字段规定下午2点前退房按当天计算之后退房加收半天。这种规则用配置驱动比写死在Java代码里更灵活酒店调价或调整规则时不用重新部署。4. 部署流程与避坑记录从源码导入到稳定运行的四个高频故障4.1 环境版本匹配JDK、Tomcat、MySQL的兼容性组合这个项目是JSP加SSM架构环境版本选择比Spring Boot更讲究。从项目配置可以推断源码基于JDK 1.8编译Tomcat建议用8.5版本MySQL不要装8.0以上版本。MyBatis 3.x搭配MySQL 5.7是经典组合如果硬上MySQL 8.0数据库驱动需要换成mysql-connector-java 8.x且URL要加serverTimezone参数否则报错时区问题。!-- pom.xml 关键依赖版本 -- properties spring.version4.3.25.RELEASE/spring.version mybatis.version3.4.6/mybatis.version /properties注意SSM项目不用Spring Boot依赖版本由pom.xml或lib目录管理。Spring 4.x对应JDK 1.8完全兼容MyBatis 3.4.6支持Mapper XML里的#{}预编译。如果项目中pom.xml缺失说明用的是Eclipse Dynamic Web Project导入本地jar包的方式这时要检查lib目录下的jar包里是否有mysql-connector-java-5.1.x和jstl相关的两个jar。JSTL缺失会导致JSP页面里的c:forEach标签直接报错页面白屏且控制台有ClassNotFoundException。4.2 部署步骤从导入到启动的完整流程拿到源码后推荐用IDEA导入Maven项目如果没有pom.xml则用Eclipse的Import Existing Projects。部署路线分五步走创建数据库、修改数据源配置、配置Tomcat、部署war包、启动验证。# 1. 创建数据库并导入项目自带的SQL脚本 mysql -u root -p mysql CREATE DATABASE hotel_room DEFAULT CHARSET utf8; mysql USE hotel_room; mysql SOURCE /path/to/hotel.sql; # 2. 修改数据库连接配置jdbc.properties jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/hotel_room?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.passwordyour_password # 3. 启动Tomcat并部署 mvn clean package cp target/hotel-room.war /path/to/tomcat/webapps/ sh /path/to/tomcat/bin/startup.sh参数说明数据库编码必须用utf8否则中文字段在查询时出现乱码。jdbc.url里characterEncodingutf8控制JDBC连接层面的字符集整个链路JSP页面、Tomcat、JDBC、MySQL任何一环编码不一致都会导致存入数据库的中文字符变成问号。如果项目自带SQL文件文件名里会有hotel或room字样没有SQL文件的情况可以从源码的Mapper映射里逆向推导建表语句。部署完成后的验证路径启动Tomcat后访问http://localhost:8080/hotel-room/如果看到登录页用管理员账号登录后能进入用户管理页面说明核心链路已经打通。常见默认账号是admin/admin123具体以项目文档为准。4.3 高频故障排查四个踩坑记录故障一Tomcat能启动但页面404 现象访问首页返回404控制台没有任何报错。 原因war包部署路径和context-path不匹配或访问URL少写了项目名。 解决确认war包名字是hotel-room.war访问地址必须带/hotel-room前缀。如果项目用ROOT.war部署则不需要加前缀。故障二数据库连接报Communications link failure 现象程序启动时报无法连接MySQL错误码是CommunicationsException。 原因MySQL 5.7默认只监听localhost如果jdbc.url里写成127.0.0.1部分版本会因host匹配问题拒绝连接。 解决检查数据库端口是否被占用再用命令行工具验证账号权限——执行GRANT ALL PRIVILEGES ON hotel_room.* TO rootlocalhost IDENTIFIED BY password; 刷新权限后重试。故障三JSP页面中文全部乱码 现象页面上中文显示为??但数据库里数据正常。 原因JSP页面本身编码不是UTF-8。项目里如果index.jsp.bak这类备份文件说明原文件被改过页面可能没有设置contentType。 解决在所有JSP页面头部检查pageEncoding属性统一为UTF-8。同时web.xml里配置CharacterEncodingFilter强制所有请求和响应走UTF-8编码这是SSM项目最标准的做法。故障四启动报BeanCreationException提示找不到Mapper 现象Spring容器初始化失败报NoSuchBeanDefinitionException指向某个Mapper接口。 原因applicationContext.xml里没有扫描到Mapper接口包或者SqlSessionFactoryBean的mapperLocations路径不对。 解决检查spring配置里base-package是否覆盖了Mapper所在的包路径项目中通常是com.hotel.mapper再确认mapperLocations的classpath路径和实际mapper.xml存放位置一致。SSM项目里这是最常见的配置错误十个项目里有七个栽在这上面。5. 进阶验证用Postman跑通预定接口并扩展报表统计5.1 用Postman验证核心接口的完整链路部署成功后很多人直接浏览器点页面发现功能都是通的就不再做接口层验证。实际上接口验证比页面点击更能暴露问题——特别是异常参数、权限拦截这类场景。推荐用Postman按下面流程跑一遍预定接口确认后端逻辑健壮性。# 步骤一模拟用户登录拿Session POST http://localhost:8080/hotel-room/user/login Content-Type: application/x-www-form-urlencoded usernameadminpasswordadmin123 # 步骤二查询空闲客房列表 GET http://localhost:8080/hotel-room/room/list?status0 # 步骤三创建预定订单 POST http://localhost:8080/hotel-room/order/create Content-Type: application/json { roomId: 1, userId: 1, checkInDate: 2025-06-01, checkOutDate: 2025-06-03 }参数说明Postman建议开一个Collection保存这组请求登录接口返回后自带Cookie后续请求会自动携带JSessionId。验证时要特别关注两点一是创建预定时返回的JSON里orderNo是否唯一连续提交两次如果生成重复单号说明生成算法需要修复二是重复预定同一间客房时服务端是否返回友好错误提示而不是500异常。正常的项目应该返回code:500和message:客房不存在或不可预定这是前面Transactional加的运行时异常被全局异常处理器捕获后的结果。如果Postman里接口返回正常但页面上Ajax调用失败优先检查F12控制台看请求路径——浏览器会自动给相对路径加上当前域名和项目名如果JS里写了全路径部署环境变化后就容易404。5.2 扩展思路报表统计与数据展示的改造方向摘要描述里提到报表统计功能包括入住率报表和客房类型统计。看源码后会发现这类功能通常做得比较基础一般就是Controller里查一次COUNT把结果塞进ModelAndView。想扩展成带图表的统计页有个性价比很高的方案把统计SQL单独拆出来用JavaScript图表库渲染。-- 按客房类型统计入住率 SELECT rt.type_name, COUNT(hf.id) AS total_rooms, SUM(CASE WHEN hr.status 2 THEN 1 ELSE 0 END) AS checked_in_rooms, CONCAT(ROUND(SUM(CASE WHEN hr.status 2 THEN 1 ELSE 0 END) / COUNT(hf.id) * 100, 2), %) AS occupancy_rate FROM room_type rt LEFT JOIN hotel_room hr ON rt.id hr.room_type_id LEFT JOIN check_in_record hf ON hr.id hf.room_id AND hf.check_out_time IS NULL GROUP BY rt.id, rt.type_name;这段SQL会返回每个客房类型的总房间数、当前在住房间数和入住率。常见做法是在Service层写一个统计方法返回ListMapString, ObjectController转换后以JSON格式传给前端图表库比如ECharts渲染。要注意LEFT JOIN的用法——用内连接会漏掉当前没有入住记录的房间类型统计结果不完整。统计查询对性能不敏感因为数据量小但如果入住记录表增长很快建议在check_out_time字段上建索引避免全表扫描拖慢页面。扩展报表功能时有个隐性需求要处理好报表页面的访问权限。项目经理或财务人员才能看统计普通前台不应该看到入住率。这个系统已经有了管理员和普通用户的角色区分统计页面统一放在/admin/statistics路径下复用LoginInterceptor里对/admin/前缀的拦截即可不需要额外开发。从那以后我每次拿到这类SSM毕设项目源码都会强制走一遍Postman接口验证——浏览器点页面的操作可以被前端脚本掩盖后端错误接口层的裸调用才能暴露真实问题。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/22 16:07:25 · 阅读 1.2k 基于SSM+MySQL的酒店客房预定管理系统：设计与实现技术拆解
简介一套基于SSMSpringSpringMVCMyBatis与MySQL的酒店客房预定管理系统完整项目面向毕业设计、课程设计及需要快速掌握Java Web开发流程的初学者。系统覆盖个人中心、用户管理、客房类型管理、客房预定、开房记录、退房结账、系统管理等模块业务流程完整具备权限分级与基础报表统计能力。压缩包共含1254个文件以java源码、jsp页面、js脚本、css样式及png/gif图片资源为主另含sql数据库脚本、xml配置文件、设计文档、部署说明和视频演示整体约18.9MB。资源已经过测试校正可百分百运行帮助读者省去环境搭建和排错时间直接对照学习SSM整合思路与酒店管理业务实现。目前已有185人学习下载适合作为实战练手或毕业设计参考。1. 基于SSMMySQL的酒店客房预定管理系统毕业设计项目的核心技术拆解做毕设选项目最怕的不是功能少而是源码拿到手跑不起来。这套基于SSM框架SpringSpringMVCMyBatis的酒店客房预定管理系统属于典型的Java Web课程设计/毕业设计项目——Spring管理业务对象SpringMVC接收请求MyBatis操作MySQL数据库前端用JSP渲染页面配了Bootstrap和ElementUI做界面样式。项目源码经过测试校正附带完整设计文档和部署说明适合需要快速交付的从业者不管是做毕业设计还是课程设计拿到就能跑通省去从零搭框架的时间。接下来按实际拆解路径走先讲SSM架构和数据库设计再拆核心业务代码最后落到部署和排错。2. SSM三层架构与MySQL表设计从配置链路到九张核心表2.1 为什么选SSM框架三层架构的职责边界SSM是老牌组合Spring负责Bean管理SpringMVC负责Web层请求分发MyBatis负责数据持久化。它的核心优势在于职责边界清晰控制层Controller只做参数接收和视图跳转业务层Service只处理业务逻辑数据层Mapper只做SQL映射。这种分层方式特别适合酒店客房预定这种业务模型相对固定的系统每张表的增删改查都能对应到Mapper接口扩展新功能时不会牵一发动全身。对比Spring Boot的单体服务风格SSM虽然配置繁琐但每个配置文件都是显式声明适合理解Java Web的请求流转过程。常见做法是Spring负责Service层Bean管理SpringMVC负责Controller层MyBatis负责Mapper层与数据库的连接管理。这个系统里三者协作路径是浏览器请求 → DispatcherServlet → Controller → Service → Mapper → MySQL返回路径反向走最终由视图解析器渲染JSP页面。2.2 数据库表设计预定、开房、退房三张业务表的状态关联从项目源码里的实体类可以反推出表结构。系统核心角色分管理员和普通用户围绕客房产生预定、开房、退房三条业务链路。表的设计遵循第三范式把用户表、客房表、类型表拆分独立通过外键关联。需要重点理解的是预定、开房记录、退房结账三张表的关系预定表存客户预定意向开房记录表存实际入住信息退房结账表算费用。这三张表通过客房ID和用户ID串联起来。-- 客房类型表 CREATE TABLE room_type ( id INT PRIMARY KEY AUTO_INCREMENT, type_name VARCHAR(50) NOT NULL COMMENT 类型名称如标准间/大床房, price DECIMAL(10,2) NOT NULL COMMENT 单价按晚计价, remark VARCHAR(255) COMMENT 备注 ) ENGINEInnoDB DEFAULT CHARSETutf8; -- 酒店客房表 CREATE TABLE hotel_room ( id INT PRIMARY KEY AUTO_INCREMENT, room_no VARCHAR(20) NOT NULL COMMENT 房号如8801, room_type_id INT NOT NULL COMMENT 外键客房类型ID, status TINYINT DEFAULT 0 COMMENT 状态0空闲 1已预定 2已入住, floor INT COMMENT 楼层, FOREIGN KEY (room_type_id) REFERENCES room_type(id) ) ENGINEInnoDB DEFAULT CHARSETutf8; -- 客房预定表 CREATE TABLE room_order ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL COMMENT 外键预定客户ID, room_id INT NOT NULL COMMENT 外键客房ID, order_no VARCHAR(32) NOT NULL COMMENT 预定单号, check_in_date DATE NOT NULL COMMENT 计划入住日期, check_out_date DATE NOT NULL COMMENT 计划退房日期, order_status TINYINT DEFAULT 0 COMMENT 预定状态0有效 1已取消 2已入住, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (user_id) REFERENCES sys_user(id), FOREIGN KEY (room_id) REFERENCES hotel_room(id) ) ENGINEInnoDB DEFAULT CHARSETutf8;参数说明room_type_id设置外键约束保证客房必须归属一个有效类型status用TINYINT存状态码而不是字符串查询效率更高后续加状态只需扩展数字含义。room_order表里order_no用32位VARCHAR存唯一单号方便订单追踪实际项目里单号一般用时间戳加随机数拼接生成。check_in_date和check_out_date用DATE类型避免DATETIME带来的时分秒干扰日期间隔计算直接做日期减法即可。这里有个设计细节值得注意预定表和开房记录表没有合并成一张表。刚开始做容易犯的错是把预定、入住、退房全塞进一张订单表用状态字段区分。拆开的好处是——预定是客户行为可能有取消操作开房记录是酒店行为涉及房间分配和押金退房结账是财务行为涉及实收金额。三张表各自记录生命周期报表统计时用JOIN关联即可。2.3 配置文件链路web.xml、spring-mvc.xml、mybatis-config.xml的协作方式SSM项目最容易翻车的地方在配置文件这个项目从源码里能看到完整的配置链。web.xml负责启动Spring容器和SpringMVC前端控制器spring-mvc.xml负责扫描Controller和配置视图解析器applicationContext.xml扫描Service和Mappermybatis-config.xml配置MyBatis全局参数。配置文件之间通过contextConfigLocation和classpath引用串联。!-- web.xml 核心片段 -- context-param param-namecontextConfigLocation/param-name param-valueclasspath:applicationContext.xml/param-value /context-param listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener servlet servlet-namespringmvc/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namespringmvc/servlet-name url-pattern//url-pattern /servlet-mapping!-- spring-mvc.xml 核心配置 -- context:component-scan base-packagecom.hotel.controller/ bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/views// property namesuffix value.jsp/ /bean逻辑说明web.xml里DispatcherServlet拦截/路径所有请求进入SpringMVC前端控制器spring-mvc.xml只扫描controller包避免把Service层重复纳入Web容器管理。视图解析器配置prefix和suffix后Controller返回字符串room/list会自动拼接成/WEB-INF/views/room/list.jsp。这种配置方式下JSP页面放在WEB-INF目录里用户不能直接通过URL访问强制走Controller安全性更好。MyBatis部分的配置核心在mapper.xml里系统源码里每张表对应一个Mapper接口加一个XML文件比如RoomMapper.xml里写SQLRoomMapper.java里定义方法。项目里SQL写法和MyBatis-Plus不同更接近原生SQL适合理解数据访问层的工作原理。3. 核心业务实现登录鉴权、客房预定与退房结算的代码拆解3.1 登录鉴权拦截器与Session的角色权限控制用户权限管理在系统里通过SpringMVC拦截器实现分管理员和普通用户两种角色。拦截器统一处理Session校验避免每个Controller重复写判断逻辑。项目里的登录流程是前端表单提交用户名密码Controller调用UserService查询MySQL密码匹配后把用户信息放入Session跳转对应首页。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object user session.getAttribute(loginUser); if (user null) { // 未登录重定向到登录页 response.sendRedirect(request.getContextPath() /login); return false; } // 管理员路径校验要求session中的role字段为1 String uri request.getRequestURI(); if (uri.contains(/admin/)) { Object role session.getAttribute(userRole); if (role null || !1.equals(role.toString())) { response.sendRedirect(request.getContextPath() /index); return false; } } return true; } }参数说明preHandle返回false表示请求被拦截不再进入Controller。userRole字段在登录成功后写入Session值为1代表管理员0代表普通用户。这里做的是一个粗粒度权限控制——限制普通用户不能访问/admin/前缀的路径细粒度的按钮级权限在JSP用c:if标签判断。实际开发中如果权限层级复杂建议引入角色表、菜单表、角色菜单关联表但在这个规模的项目里Session存角色字段足够了改动成本低。3.2 客房预定业务状态机流转与并发控制客房预定是整个系统的核心业务涉及客房状态变更、订单生成、类型价格读取三个动作。系统把预定定义为客户选客房、填入住日期、生成订单、修改客房status为1已预定。这里有前后端联动的逻辑前端通过Ajax传参数Controller接收后开始事务。一个容易被忽略的点是状态判断预定前必须确认客房status是0空闲否则不能下单。Transactional public boolean createOrder(RoomOrder order, Integer roomId) { // 1. 锁定客房并检查状态 HotelRoom room roomMapper.selectByIdForUpdate(roomId); if (room null || room.getStatus() ! 0) { throw new RuntimeException(客房不存在或不可预定); } // 2. 生成订单号时间戳 随机数 String orderNo generateOrderNo(); order.setOrderNo(orderNo); order.setOrderStatus(0); // 3. 更新客房状态为已预定 int update roomMapper.updateStatus(roomId, 1); if (update ! 1) { throw new RuntimeException(客房状态更新失败); } // 4. 保存订单 return orderMapper.insert(order) 0; }参数说明Transactional保证三个阶段要么全部成功要么全部回滚。selectByIdForUpdate是悲观锁写法MySQL执行SELECT ... FOR UPDATE锁定该行直到事务结束防止两个用户同时预定同一间客房。generateOrderNo里常见做法是System.currentTimeMillis()加三位随机数拼成32位字符串保证并发下不重复。这种用锁保证一致性的方案适合小规模系统缺点是并发量上去后锁竞争明显但毕设项目这个量级完全够用。预定状态流转的完整链路是空闲0→ 已预定1→ 已入住2→ 空闲0。用户取消预定状态从1回到0用户办理入住状态从1变2退房结账后状态从2回到0。这个状态机在Service层通过if判断控制没有引入状态机框架逻辑直观便于维护。3.3 开房记录与退房结账金额计算的边界条件开房记录和退房结账是两个紧邻的操作开房时把预定订单状态改为已入住同时创建一条开房记录退房时根据入住天数和客房类型单价计算总费用生成结账记录。金额计算最大的坑在跨天计算——早上6点入住和下午6点入住退房时的计费方式不同这个逻辑在源码里的实现方式是查入住时间按自然日差值计算。public BigDecimal settleAccounts(Integer recordId) { // 1. 查询开房记录拿到入住时间和退房时间 CheckInRecord record checkInRecordMapper.selectById(recordId); // 2. 计算入住天数按日历日计算不足一天按一天计 int days calculateDays(record.getCheckInTime(), record.getCheckOutTime()); // 3. 读取客房类型单价 RoomType roomType roomTypeMapper.selectById(record.getRoomTypeId()); BigDecimal total roomType.getPrice().multiply(BigDecimal.valueOf(days)); // 4. 生成退房结账记录 CheckoutRecord checkout new CheckoutRecord(); checkout.setRecordId(recordId); checkout.setTotalAmount(total); checkout.setCreateTime(new Date()); return checkoutRecordMapper.insert(checkout) 0 ? total : null; } private int calculateDays(Date in, Date out) { long diffMs out.getTime() - in.getTime(); long diffDays diffMs / (1000 * 60 * 60 * 24); long remainder diffMs % (1000 * 60 * 60 * 24); return remainder 0 ? (int) diffDays 1 : (int) diffDays; }参数说明BigDecimal用于金额计算避免double精度丢失——这是财务相关的硬性要求总价计算不能出现0.999999这种结果。calculateDays用毫秒差值取整余数大于0就加一天模拟的是住了3小时也算一天的酒店规则。这个方法是退房结账最容易出bug的地方很多毕设项目在这里直接做天数减法没考虑时分秒带来的误差导致结账金额和预期不符。如果项目需要升级推荐把计费规则做进数据库配置表比如设置一个cutoffTime字段规定下午2点前退房按当天计算之后退房加收半天。这种规则用配置驱动比写死在Java代码里更灵活酒店调价或调整规则时不用重新部署。4. 部署流程与避坑记录从源码导入到稳定运行的四个高频故障4.1 环境版本匹配JDK、Tomcat、MySQL的兼容性组合这个项目是JSP加SSM架构环境版本选择比Spring Boot更讲究。从项目配置可以推断源码基于JDK 1.8编译Tomcat建议用8.5版本MySQL不要装8.0以上版本。MyBatis 3.x搭配MySQL 5.7是经典组合如果硬上MySQL 8.0数据库驱动需要换成mysql-connector-java 8.x且URL要加serverTimezone参数否则报错时区问题。!-- pom.xml 关键依赖版本 -- properties spring.version4.3.25.RELEASE/spring.version mybatis.version3.4.6/mybatis.version /properties注意SSM项目不用Spring Boot依赖版本由pom.xml或lib目录管理。Spring 4.x对应JDK 1.8完全兼容MyBatis 3.4.6支持Mapper XML里的#{}预编译。如果项目中pom.xml缺失说明用的是Eclipse Dynamic Web Project导入本地jar包的方式这时要检查lib目录下的jar包里是否有mysql-connector-java-5.1.x和jstl相关的两个jar。JSTL缺失会导致JSP页面里的c:forEach标签直接报错页面白屏且控制台有ClassNotFoundException。4.2 部署步骤从导入到启动的完整流程拿到源码后推荐用IDEA导入Maven项目如果没有pom.xml则用Eclipse的Import Existing Projects。部署路线分五步走创建数据库、修改数据源配置、配置Tomcat、部署war包、启动验证。# 1. 创建数据库并导入项目自带的SQL脚本 mysql -u root -p mysql CREATE DATABASE hotel_room DEFAULT CHARSET utf8; mysql USE hotel_room; mysql SOURCE /path/to/hotel.sql; # 2. 修改数据库连接配置jdbc.properties jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/hotel_room?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.passwordyour_password # 3. 启动Tomcat并部署 mvn clean package cp target/hotel-room.war /path/to/tomcat/webapps/ sh /path/to/tomcat/bin/startup.sh参数说明数据库编码必须用utf8否则中文字段在查询时出现乱码。jdbc.url里characterEncodingutf8控制JDBC连接层面的字符集整个链路JSP页面、Tomcat、JDBC、MySQL任何一环编码不一致都会导致存入数据库的中文字符变成问号。如果项目自带SQL文件文件名里会有hotel或room字样没有SQL文件的情况可以从源码的Mapper映射里逆向推导建表语句。部署完成后的验证路径启动Tomcat后访问http://localhost:8080/hotel-room/如果看到登录页用管理员账号登录后能进入用户管理页面说明核心链路已经打通。常见默认账号是admin/admin123具体以项目文档为准。4.3 高频故障排查四个踩坑记录故障一Tomcat能启动但页面404 现象访问首页返回404控制台没有任何报错。 原因war包部署路径和context-path不匹配或访问URL少写了项目名。 解决确认war包名字是hotel-room.war访问地址必须带/hotel-room前缀。如果项目用ROOT.war部署则不需要加前缀。故障二数据库连接报Communications link failure 现象程序启动时报无法连接MySQL错误码是CommunicationsException。 原因MySQL 5.7默认只监听localhost如果jdbc.url里写成127.0.0.1部分版本会因host匹配问题拒绝连接。 解决检查数据库端口是否被占用再用命令行工具验证账号权限——执行GRANT ALL PRIVILEGES ON hotel_room.* TO rootlocalhost IDENTIFIED BY password; 刷新权限后重试。故障三JSP页面中文全部乱码 现象页面上中文显示为??但数据库里数据正常。 原因JSP页面本身编码不是UTF-8。项目里如果index.jsp.bak这类备份文件说明原文件被改过页面可能没有设置contentType。 解决在所有JSP页面头部检查pageEncoding属性统一为UTF-8。同时web.xml里配置CharacterEncodingFilter强制所有请求和响应走UTF-8编码这是SSM项目最标准的做法。故障四启动报BeanCreationException提示找不到Mapper 现象Spring容器初始化失败报NoSuchBeanDefinitionException指向某个Mapper接口。 原因applicationContext.xml里没有扫描到Mapper接口包或者SqlSessionFactoryBean的mapperLocations路径不对。 解决检查spring配置里base-package是否覆盖了Mapper所在的包路径项目中通常是com.hotel.mapper再确认mapperLocations的classpath路径和实际mapper.xml存放位置一致。SSM项目里这是最常见的配置错误十个项目里有七个栽在这上面。5. 进阶验证用Postman跑通预定接口并扩展报表统计5.1 用Postman验证核心接口的完整链路部署成功后很多人直接浏览器点页面发现功能都是通的就不再做接口层验证。实际上接口验证比页面点击更能暴露问题——特别是异常参数、权限拦截这类场景。推荐用Postman按下面流程跑一遍预定接口确认后端逻辑健壮性。# 步骤一模拟用户登录拿Session POST http://localhost:8080/hotel-room/user/login Content-Type: application/x-www-form-urlencoded usernameadminpasswordadmin123 # 步骤二查询空闲客房列表 GET http://localhost:8080/hotel-room/room/list?status0 # 步骤三创建预定订单 POST http://localhost:8080/hotel-room/order/create Content-Type: application/json { roomId: 1, userId: 1, checkInDate: 2025-06-01, checkOutDate: 2025-06-03 }参数说明Postman建议开一个Collection保存这组请求登录接口返回后自带Cookie后续请求会自动携带JSessionId。验证时要特别关注两点一是创建预定时返回的JSON里orderNo是否唯一连续提交两次如果生成重复单号说明生成算法需要修复二是重复预定同一间客房时服务端是否返回友好错误提示而不是500异常。正常的项目应该返回code:500和message:客房不存在或不可预定这是前面Transactional加的运行时异常被全局异常处理器捕获后的结果。如果Postman里接口返回正常但页面上Ajax调用失败优先检查F12控制台看请求路径——浏览器会自动给相对路径加上当前域名和项目名如果JS里写了全路径部署环境变化后就容易404。5.2 扩展思路报表统计与数据展示的改造方向摘要描述里提到报表统计功能包括入住率报表和客房类型统计。看源码后会发现这类功能通常做得比较基础一般就是Controller里查一次COUNT把结果塞进ModelAndView。想扩展成带图表的统计页有个性价比很高的方案把统计SQL单独拆出来用JavaScript图表库渲染。-- 按客房类型统计入住率 SELECT rt.type_name, COUNT(hf.id) AS total_rooms, SUM(CASE WHEN hr.status 2 THEN 1 ELSE 0 END) AS checked_in_rooms, CONCAT(ROUND(SUM(CASE WHEN hr.status 2 THEN 1 ELSE 0 END) / COUNT(hf.id) * 100, 2), %) AS occupancy_rate FROM room_type rt LEFT JOIN hotel_room hr ON rt.id hr.room_type_id LEFT JOIN check_in_record hf ON hr.id hf.room_id AND hf.check_out_time IS NULL GROUP BY rt.id, rt.type_name;这段SQL会返回每个客房类型的总房间数、当前在住房间数和入住率。常见做法是在Service层写一个统计方法返回ListMapString, ObjectController转换后以JSON格式传给前端图表库比如ECharts渲染。要注意LEFT JOIN的用法——用内连接会漏掉当前没有入住记录的房间类型统计结果不完整。统计查询对性能不敏感因为数据量小但如果入住记录表增长很快建议在check_out_time字段上建索引避免全表扫描拖慢页面。扩展报表功能时有个隐性需求要处理好报表页面的访问权限。项目经理或财务人员才能看统计普通前台不应该看到入住率。这个系统已经有了管理员和普通用户的角色区分统计页面统一放在/admin/statistics路径下复用LoginInterceptor里对/admin/前缀的拦截即可不需要额外开发。从那以后我每次拿到这类SSM毕设项目源码都会强制走一遍Postman接口验证——浏览器点页面的操作可以被前端脚本掩盖后端错误接口层的裸调用才能暴露真实问题。希望帮到你。本文还有配套的精品资源点击获取