拓冰网站定制 
简介本资源为基于Spring Boot与Web的酒店客房管理系统完整开发资料面向计算机专业学生、Java初学者及需要课程设计或毕业设计参考的开发者帮助解决客房信息管理、客房清扫管理、用户入住与会员管理等业务场景的实现问题。压缩包共911个文件约17.68MB以178个Java源码、60个Vue组件、62个HTML页面、153个JavaScript脚本及44个CSS样式为主另含SQL建表脚本、Maven配置与项目说明文档覆盖前后端分离的完整工程结构。资源包含系统概述、可行性分析、数据库设计、功能实现与系统测试等章节并附论文文档读者可据此掌握B/S架构下的客房管理模块划分、数据库实体设计及Spring Boot与Vue的整合思路。目前已有24人学习下载适合需要快速搭建项目骨架、理解业务逻辑与撰写设计文档的读者参考。1. 从一份 7z 压缩包说起酒店客房管理系统到底要解决什么问题很多人第一次拿到「springboot基于web的酒店客房管理系统设计与实现.7z源码论文」这类压缩包时第一反应是解压、找pom.xml、mvn spring-boot:run然后浏览器一开发现登录页能出来但点「预订」报 500点「退房」数据不动。问题不在代码写得多烂而在于没搞清楚这套系统真正要闭环的业务是什么。酒店客房管理系统的核心不是「增删改查五张表」而是把房态、订单、入住人三者的状态机跑通房间从「空闲」到「已预订」到「已入住」再到「待打扫」最后回到「空闲」每一步都要有对应的数据库字段、接口和页面动作。这套基于 Spring Boot 的 Web 项目本质是用 Java 后端 浏览器前端把前台、客房、财务三个角色的日常操作搬到线上。适合谁看适合课程设计要交论文的学生、想拿一个完整 CRUD 项目练手 Spring Boot 的初级开发以及需要快速搭一套内部房态看板的小团队。下面我按「能跑起来 → 能改得动 → 能讲清楚」的顺序拆。2. 把 7z 跑起来之前环境、依赖与数据库三件事2.1 先确认 Spring Boot 版本和 JDK 的匹配关系压缩包里的pom.xml是第一个要看的东西。Spring Boot 2.x 和 3.x 对 JDK 的要求完全不同2.7.x 最低 JDK 83.x 强制 JDK 17。热搜里常出现「springboot版本太高」的抱怨多半是拿 JDK 8 去跑 3.x 项目启动直接抛UnsupportedClassVersionError。我一般先看pom.xml里parent的版本号再决定装哪个 JDK。!-- pom.xml 关键片段先看这三处 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version !-- 2.x 用 JDK8/113.x 必须 JDK17 -- /parent properties java.version8/java.version !-- 和本机 JDK 大版本对齐 -- /properties dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency /dependencies逻辑说明spring-boot-starter-parent锁定了整套依赖的版本改它等于改全局。java.version决定编译级别写 8 就不能用var、record这些语法。参数上如果本机是 JDK 17 而项目是 2.7.x能跑但会有反射警告反过来 JDK 8 跑 3.x 直接失败。失败时先看控制台第一行异常类名UnsupportedClassVersionError就是版本不匹配ClassNotFoundException多半是依赖没下全。2.2 数据库脚本导入与连接配置这类项目通常带一个sql文件夹或.sql文件里面是建库建表加初始数据。常见做法是先用 Navicat 或命令行建一个空库字符集选utf8mb4再执行脚本。注意脚本里如果有CREATE DATABASE就不要再手动建直接跑如果只有CREATE TABLE得先USE到目标库。# 命令行导入避免图形工具编码问题 mysql -u root -p --default-character-setutf8mb4 -e CREATE DATABASE hotel_db DEFAULT CHARSET utf8mb4; mysql -u root -p --default-character-setutf8mb4 hotel_db hotel_db.sql# application.yml 数据源配置 spring: datasource: url: jdbc:mysql://localhost:3306/hotel_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver逻辑说明serverTimezone不写会报时区错误这是 MySQL 8 的经典坑。characterEncodingutf8配合库的utf8mb4才能存中文和 emoji。参数上端口默认 3306如果本机装了多个 MySQL 实例要确认端口。导入后执行SELECT COUNT(*) FROM 房间表验证数据是否进去空表说明脚本只建了结构没插数据。2.3 启动与首次登录验证依赖下载完、数据库通了就可以启动。IDEA 里直接跑主类或者命令行mvn spring-boot:run。启动日志出现Started XxxApplication in x seconds才算成功。然后浏览器访问http://localhost:8080默认账号密码一般在论文或README里常见是admin/123456。# 命令行启动跳过测试加快速度 mvn clean package -DskipTests java -jar target/hotel-0.0.1-SNAPSHOT.jar逻辑说明-DskipTests跳过单元测试课程设计项目测试往往依赖真实数据库跳过能省事。打包成 jar 后可以脱离 IDE 运行方便部署到服务器。参数上端口在application.yml的server.port改被占用就换 8081。登录失败先看浏览器 F12 的 Network是 401 还是 500401 是账号密码问题500 是后端异常去控制台看堆栈。3. 房态与订单这套系统最该看懂的两张表3.1 房间表的状态字段设计酒店系统的灵魂在房间表的状态字段。常见设计是一个status字段用数字或枚举表示0 空闲、1 已预订、2 已入住、3 待打扫、4 维修。这个字段的每一次变更都必须和订单表联动否则会出现「房间显示空闲但订单还在」的脏数据。-- 房间表核心字段 CREATE TABLE room ( id INT PRIMARY KEY AUTO_INCREMENT, room_no VARCHAR(10) NOT NULL UNIQUE, -- 房号如 8801 type_id INT NOT NULL, -- 房型外键 status TINYINT DEFAULT 0, -- 0空闲 1已预订 2已入住 3待打扫 4维修 floor INT, -- 楼层方便按层筛选 price DECIMAL(10,2) -- 当前房价可随季节调整 );逻辑说明room_no加唯一索引防止重复房号。status用TINYINT省空间但要在代码里定义枚举类对应避免魔法数字。price单独存而不是从房型表实时取是为了支持旺季调价。参数上status的默认值设 0新建房间自动空闲。查询可用房就是WHERE status 0但要注意排除当天已被预订的这就要结合订单表的时间段判断。3.2 订单表与时间段的冲突检测订单表要记录入住日期和离店日期判断某房间在某时间段是否可订本质是区间重叠检测。两个时间段[checkIn, checkOut)重叠的条件是existing.checkIn newCheckOut AND existing.checkOut newCheckIn。这个逻辑写错就会出现同一间房被订两次的翻车现场。// 订单冲突检测核心逻辑 public boolean isRoomAvailable(Integer roomId, LocalDate checkIn, LocalDate checkOut) { // 查询该房间在目标时间段内未取消的订单 ListOrder orders orderMapper.selectByRoomAndDate(roomId, checkIn, checkOut); for (Order o : orders) { // 区间重叠判断已有订单的入住 新订单离店 且 已有订单离店 新订单入住 if (o.getCheckInDate().isBefore(checkOut) o.getCheckOutDate().isAfter(checkIn)) { return false; // 有重叠不可订 } } return true; }逻辑说明用LocalDate而不是Date避免时分秒干扰。isBefore和isAfter是严格比较等于的情况不算重叠符合酒店「今天退房今天可入住」的规则。参数上checkIn必须早于checkOut这个校验要在进入方法前做。失败时如果发现明明没订单却返回不可订检查 SQL 的WHERE条件是不是把已取消订单也算进去了要加status ! CANCELLED。3.3 退房与房态回写的联动退房操作不是简单改订单状态还要把房间状态从「已入住」改成「待打扫」等保洁确认后再改成「空闲」。这个链路断在哪一环房态看板就会失真。Transactional public void checkOut(Integer orderId) { Order order orderMapper.selectById(orderId); order.setStatus(CHECKED_OUT); order.setActualCheckOutTime(LocalDateTime.now()); orderMapper.updateById(order); // 房间状态改为待打扫而不是直接空闲 Room room roomMapper.selectById(order.getRoomId()); room.setStatus(3); // 3 待打扫 roomMapper.updateById(room); }逻辑说明Transactional保证订单和房间两张表要么都成功要么都回滚避免订单退了房间还显示入住。参数上status用字符串枚举比数字可读但查询性能略低课程设计项目无所谓。失败时看事务有没有生效Spring Boot 默认对RuntimeException回滚如果抛的是受检异常要手动配rollbackFor。4. 避坑与排查跑这套源码最容易栽的五个地方4.1 前端页面 404 或样式丢失现象登录页能开但跳转后白屏F12 报 404 找不到xxx.html或.css。原因这类项目前端页面常放在src/main/resources/static或templates如果用了 Thymeleaf 但没加依赖或者页面路径写的是绝对路径/pages/xxx.html而实际在/static/pages/就会 404。解决先确认pom.xml有没有spring-boot-starter-thymeleaf再看application.yml的spring.thymeleaf.prefix配置默认是classpath:/templates/。静态资源放static下访问时不要带static前缀。4.2 中文乱码从数据库一路传到浏览器现象房间名、客人姓名显示成???或房间。原因三个环节任一编码不对都会乱码——数据库连接 URL 没写characterEncodingutf8、表字段不是utf8mb4、返回 JSON 时HttpMessageConverter用了 ISO-8859-1。解决URL 加useUnicodetruecharacterEncodingutf8建库用utf8mb4Spring Boot 2.x 默认 JSON 编码已是 UTF-8如果还乱码检查有没有自定义WebMvcConfigurer覆盖了默认配置。4.3 登录后操作报 401 或权限拦截失效现象登录成功但点任何菜单都跳回登录页或者反过来没登录也能直接访问后台接口。原因拦截器HandlerInterceptor的preHandle逻辑写错或者 Session 超时时间太短。常见是拦截器放行了/login但没放行/css/**、/js/**导致登录页样式加载被拦。解决在excludePathPatterns里把静态资源和登录接口都加上Session 超时在application.yml的server.servlet.session.timeout调大比如30m。4.4 订单金额和房价对不上现象预订时显示 300 一晚住三晚订单总额却是 600 或 1200。原因计算天数用了checkOut - checkIn但没处理边界或者把price当成了总价。正确算法是ChronoUnit.DAYS.between(checkIn, checkOut)这个 API 返回的是完整天数差1号到3号返回 2符合两晚的逻辑。解决在订单创建前打印checkIn、checkOut和天数确认计算无误再乘单价。如果用了Date类型先转LocalDate再算避免时分秒导致天数差 0。4.5 打包成 jar 后页面能开但接口 500现象IDEA 里跑一切正常java -jar启动后登录报 500。原因IDEA 运行时工作目录是项目根目录能读到src/main/resources下的文件打成 jar 后资源在 classpath 里如果用new File(src/main/resources/xxx)这种路径读文件就会失败。解决统一用ClassPathResource或getClass().getResourceAsStream()读 classpath 资源。数据库配置如果写的是相对路径的 SQLite 也会出问题改成绝对路径或 MySQL。5. 从能跑到能改二次开发与论文写作的衔接技巧5.1 加一个「按楼层筛选房态」的接口拿到源码后最该练手的是加功能而不是改样式。比如加一个按楼层查房态的接口能同时练到 Controller、Service、Mapper 三层。// RoomController 新增方法 GetMapping(/listByFloor) public Result listByFloor(RequestParam Integer floor) { // 参数校验楼层不能为空且大于 0 if (floor null || floor 0) { return Result.error(楼层参数不合法); } ListRoom rooms roomService.listByFloor(floor); return Result.success(rooms); }逻辑说明RequestParam接收 URL 参数Result是项目里常见的统一返回包装类。参数上floor要做非空和范围校验否则传-1会查出空列表但不报错前端不好排查。Service 层直接调 Mapper 的自定义查询XML 里写WHERE floor #{floor} ORDER BY room_no。改完重启用 Postman 或浏览器直接访问http://localhost:8080/room/listByFloor?floor8验证。5.2 论文里「系统实现」章节该怎么写才不空论文的「系统实现」最忌讳贴大段代码。评委想看的是这个模块解决什么问题、用了什么技术、关键流程是什么、界面长什么样。我的习惯是每个模块配一张流程图用 Visio 或 draw.io 画不要截图代码然后文字描述「用户点击预订 → 前端校验日期 → 后端查房态 → 冲突则返回提示 → 无冲突则写订单并改房态」。代码只贴核心的 10 到 20 行比如上面的冲突检测逻辑贴完用一段话解释区间重叠的判断依据。这样既有技术深度又不会被说成代码堆砌。5.3 用接口文档工具反向梳理项目结构如果项目里没有 Swagger可以手动加一个顺便把接口理清楚。加依赖后访问http://localhost:8080/swagger-ui.html就能看到所有接口。dependency groupIdio.springfox/groupId artifactIdspringfox-boot-starter/artifactId version3.0.0/version /dependency逻辑说明Springfox 3.0 适配 Spring Boot 2.6如果项目是 2.7.x 可以直接用。参数上需要在启动类加EnableOpenApi并配一个DocketBean 指定扫描包。加完后所有RestController的接口会自动列出写论文时对着这个列表逐个截图比翻代码快得多。注意 Spring Boot 3.x 要用springdoc-openapiSpringfox 不兼容。5.4 一个验证系统是否真跑通的小习惯我判断一套酒店系统是否真能演示不看登录页而是走一遍完整链路新建一间房 → 用客人账号预订 → 前台确认入住 → 换房 → 退房 → 房态变待打扫 → 保洁确认变空闲。这七步走完数据都对才算跑通。任何一步数据对不上就回到对应的表和接口去查。这个习惯帮我省了很多「演示到一半翻车」的后悔药。希望帮到你。本文还有配套的精品资源点击获取 Spring Boot酒店客房管理系统：从7z源码到房态订单闭环实战
简介本资源为基于Spring Boot与Web的酒店客房管理系统完整开发资料面向计算机专业学生、Java初学者及需要课程设计或毕业设计参考的开发者帮助解决客房信息管理、客房清扫管理、用户入住与会员管理等业务场景的实现问题。压缩包共911个文件约17.68MB以178个Java源码、60个Vue组件、62个HTML页面、153个JavaScript脚本及44个CSS样式为主另含SQL建表脚本、Maven配置与项目说明文档覆盖前后端分离的完整工程结构。资源包含系统概述、可行性分析、数据库设计、功能实现与系统测试等章节并附论文文档读者可据此掌握B/S架构下的客房管理模块划分、数据库实体设计及Spring Boot与Vue的整合思路。目前已有24人学习下载适合需要快速搭建项目骨架、理解业务逻辑与撰写设计文档的读者参考。1. 从一份 7z 压缩包说起酒店客房管理系统到底要解决什么问题很多人第一次拿到「springboot基于web的酒店客房管理系统设计与实现.7z源码论文」这类压缩包时第一反应是解压、找pom.xml、mvn spring-boot:run然后浏览器一开发现登录页能出来但点「预订」报 500点「退房」数据不动。问题不在代码写得多烂而在于没搞清楚这套系统真正要闭环的业务是什么。酒店客房管理系统的核心不是「增删改查五张表」而是把房态、订单、入住人三者的状态机跑通房间从「空闲」到「已预订」到「已入住」再到「待打扫」最后回到「空闲」每一步都要有对应的数据库字段、接口和页面动作。这套基于 Spring Boot 的 Web 项目本质是用 Java 后端 浏览器前端把前台、客房、财务三个角色的日常操作搬到线上。适合谁看适合课程设计要交论文的学生、想拿一个完整 CRUD 项目练手 Spring Boot 的初级开发以及需要快速搭一套内部房态看板的小团队。下面我按「能跑起来 → 能改得动 → 能讲清楚」的顺序拆。2. 把 7z 跑起来之前环境、依赖与数据库三件事2.1 先确认 Spring Boot 版本和 JDK 的匹配关系压缩包里的pom.xml是第一个要看的东西。Spring Boot 2.x 和 3.x 对 JDK 的要求完全不同2.7.x 最低 JDK 83.x 强制 JDK 17。热搜里常出现「springboot版本太高」的抱怨多半是拿 JDK 8 去跑 3.x 项目启动直接抛UnsupportedClassVersionError。我一般先看pom.xml里parent的版本号再决定装哪个 JDK。!-- pom.xml 关键片段先看这三处 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version !-- 2.x 用 JDK8/113.x 必须 JDK17 -- /parent properties java.version8/java.version !-- 和本机 JDK 大版本对齐 -- /properties dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency /dependencies逻辑说明spring-boot-starter-parent锁定了整套依赖的版本改它等于改全局。java.version决定编译级别写 8 就不能用var、record这些语法。参数上如果本机是 JDK 17 而项目是 2.7.x能跑但会有反射警告反过来 JDK 8 跑 3.x 直接失败。失败时先看控制台第一行异常类名UnsupportedClassVersionError就是版本不匹配ClassNotFoundException多半是依赖没下全。2.2 数据库脚本导入与连接配置这类项目通常带一个sql文件夹或.sql文件里面是建库建表加初始数据。常见做法是先用 Navicat 或命令行建一个空库字符集选utf8mb4再执行脚本。注意脚本里如果有CREATE DATABASE就不要再手动建直接跑如果只有CREATE TABLE得先USE到目标库。# 命令行导入避免图形工具编码问题 mysql -u root -p --default-character-setutf8mb4 -e CREATE DATABASE hotel_db DEFAULT CHARSET utf8mb4; mysql -u root -p --default-character-setutf8mb4 hotel_db hotel_db.sql# application.yml 数据源配置 spring: datasource: url: jdbc:mysql://localhost:3306/hotel_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver逻辑说明serverTimezone不写会报时区错误这是 MySQL 8 的经典坑。characterEncodingutf8配合库的utf8mb4才能存中文和 emoji。参数上端口默认 3306如果本机装了多个 MySQL 实例要确认端口。导入后执行SELECT COUNT(*) FROM 房间表验证数据是否进去空表说明脚本只建了结构没插数据。2.3 启动与首次登录验证依赖下载完、数据库通了就可以启动。IDEA 里直接跑主类或者命令行mvn spring-boot:run。启动日志出现Started XxxApplication in x seconds才算成功。然后浏览器访问http://localhost:8080默认账号密码一般在论文或README里常见是admin/123456。# 命令行启动跳过测试加快速度 mvn clean package -DskipTests java -jar target/hotel-0.0.1-SNAPSHOT.jar逻辑说明-DskipTests跳过单元测试课程设计项目测试往往依赖真实数据库跳过能省事。打包成 jar 后可以脱离 IDE 运行方便部署到服务器。参数上端口在application.yml的server.port改被占用就换 8081。登录失败先看浏览器 F12 的 Network是 401 还是 500401 是账号密码问题500 是后端异常去控制台看堆栈。3. 房态与订单这套系统最该看懂的两张表3.1 房间表的状态字段设计酒店系统的灵魂在房间表的状态字段。常见设计是一个status字段用数字或枚举表示0 空闲、1 已预订、2 已入住、3 待打扫、4 维修。这个字段的每一次变更都必须和订单表联动否则会出现「房间显示空闲但订单还在」的脏数据。-- 房间表核心字段 CREATE TABLE room ( id INT PRIMARY KEY AUTO_INCREMENT, room_no VARCHAR(10) NOT NULL UNIQUE, -- 房号如 8801 type_id INT NOT NULL, -- 房型外键 status TINYINT DEFAULT 0, -- 0空闲 1已预订 2已入住 3待打扫 4维修 floor INT, -- 楼层方便按层筛选 price DECIMAL(10,2) -- 当前房价可随季节调整 );逻辑说明room_no加唯一索引防止重复房号。status用TINYINT省空间但要在代码里定义枚举类对应避免魔法数字。price单独存而不是从房型表实时取是为了支持旺季调价。参数上status的默认值设 0新建房间自动空闲。查询可用房就是WHERE status 0但要注意排除当天已被预订的这就要结合订单表的时间段判断。3.2 订单表与时间段的冲突检测订单表要记录入住日期和离店日期判断某房间在某时间段是否可订本质是区间重叠检测。两个时间段[checkIn, checkOut)重叠的条件是existing.checkIn newCheckOut AND existing.checkOut newCheckIn。这个逻辑写错就会出现同一间房被订两次的翻车现场。// 订单冲突检测核心逻辑 public boolean isRoomAvailable(Integer roomId, LocalDate checkIn, LocalDate checkOut) { // 查询该房间在目标时间段内未取消的订单 ListOrder orders orderMapper.selectByRoomAndDate(roomId, checkIn, checkOut); for (Order o : orders) { // 区间重叠判断已有订单的入住 新订单离店 且 已有订单离店 新订单入住 if (o.getCheckInDate().isBefore(checkOut) o.getCheckOutDate().isAfter(checkIn)) { return false; // 有重叠不可订 } } return true; }逻辑说明用LocalDate而不是Date避免时分秒干扰。isBefore和isAfter是严格比较等于的情况不算重叠符合酒店「今天退房今天可入住」的规则。参数上checkIn必须早于checkOut这个校验要在进入方法前做。失败时如果发现明明没订单却返回不可订检查 SQL 的WHERE条件是不是把已取消订单也算进去了要加status ! CANCELLED。3.3 退房与房态回写的联动退房操作不是简单改订单状态还要把房间状态从「已入住」改成「待打扫」等保洁确认后再改成「空闲」。这个链路断在哪一环房态看板就会失真。Transactional public void checkOut(Integer orderId) { Order order orderMapper.selectById(orderId); order.setStatus(CHECKED_OUT); order.setActualCheckOutTime(LocalDateTime.now()); orderMapper.updateById(order); // 房间状态改为待打扫而不是直接空闲 Room room roomMapper.selectById(order.getRoomId()); room.setStatus(3); // 3 待打扫 roomMapper.updateById(room); }逻辑说明Transactional保证订单和房间两张表要么都成功要么都回滚避免订单退了房间还显示入住。参数上status用字符串枚举比数字可读但查询性能略低课程设计项目无所谓。失败时看事务有没有生效Spring Boot 默认对RuntimeException回滚如果抛的是受检异常要手动配rollbackFor。4. 避坑与排查跑这套源码最容易栽的五个地方4.1 前端页面 404 或样式丢失现象登录页能开但跳转后白屏F12 报 404 找不到xxx.html或.css。原因这类项目前端页面常放在src/main/resources/static或templates如果用了 Thymeleaf 但没加依赖或者页面路径写的是绝对路径/pages/xxx.html而实际在/static/pages/就会 404。解决先确认pom.xml有没有spring-boot-starter-thymeleaf再看application.yml的spring.thymeleaf.prefix配置默认是classpath:/templates/。静态资源放static下访问时不要带static前缀。4.2 中文乱码从数据库一路传到浏览器现象房间名、客人姓名显示成???或房间。原因三个环节任一编码不对都会乱码——数据库连接 URL 没写characterEncodingutf8、表字段不是utf8mb4、返回 JSON 时HttpMessageConverter用了 ISO-8859-1。解决URL 加useUnicodetruecharacterEncodingutf8建库用utf8mb4Spring Boot 2.x 默认 JSON 编码已是 UTF-8如果还乱码检查有没有自定义WebMvcConfigurer覆盖了默认配置。4.3 登录后操作报 401 或权限拦截失效现象登录成功但点任何菜单都跳回登录页或者反过来没登录也能直接访问后台接口。原因拦截器HandlerInterceptor的preHandle逻辑写错或者 Session 超时时间太短。常见是拦截器放行了/login但没放行/css/**、/js/**导致登录页样式加载被拦。解决在excludePathPatterns里把静态资源和登录接口都加上Session 超时在application.yml的server.servlet.session.timeout调大比如30m。4.4 订单金额和房价对不上现象预订时显示 300 一晚住三晚订单总额却是 600 或 1200。原因计算天数用了checkOut - checkIn但没处理边界或者把price当成了总价。正确算法是ChronoUnit.DAYS.between(checkIn, checkOut)这个 API 返回的是完整天数差1号到3号返回 2符合两晚的逻辑。解决在订单创建前打印checkIn、checkOut和天数确认计算无误再乘单价。如果用了Date类型先转LocalDate再算避免时分秒导致天数差 0。4.5 打包成 jar 后页面能开但接口 500现象IDEA 里跑一切正常java -jar启动后登录报 500。原因IDEA 运行时工作目录是项目根目录能读到src/main/resources下的文件打成 jar 后资源在 classpath 里如果用new File(src/main/resources/xxx)这种路径读文件就会失败。解决统一用ClassPathResource或getClass().getResourceAsStream()读 classpath 资源。数据库配置如果写的是相对路径的 SQLite 也会出问题改成绝对路径或 MySQL。5. 从能跑到能改二次开发与论文写作的衔接技巧5.1 加一个「按楼层筛选房态」的接口拿到源码后最该练手的是加功能而不是改样式。比如加一个按楼层查房态的接口能同时练到 Controller、Service、Mapper 三层。// RoomController 新增方法 GetMapping(/listByFloor) public Result listByFloor(RequestParam Integer floor) { // 参数校验楼层不能为空且大于 0 if (floor null || floor 0) { return Result.error(楼层参数不合法); } ListRoom rooms roomService.listByFloor(floor); return Result.success(rooms); }逻辑说明RequestParam接收 URL 参数Result是项目里常见的统一返回包装类。参数上floor要做非空和范围校验否则传-1会查出空列表但不报错前端不好排查。Service 层直接调 Mapper 的自定义查询XML 里写WHERE floor #{floor} ORDER BY room_no。改完重启用 Postman 或浏览器直接访问http://localhost:8080/room/listByFloor?floor8验证。5.2 论文里「系统实现」章节该怎么写才不空论文的「系统实现」最忌讳贴大段代码。评委想看的是这个模块解决什么问题、用了什么技术、关键流程是什么、界面长什么样。我的习惯是每个模块配一张流程图用 Visio 或 draw.io 画不要截图代码然后文字描述「用户点击预订 → 前端校验日期 → 后端查房态 → 冲突则返回提示 → 无冲突则写订单并改房态」。代码只贴核心的 10 到 20 行比如上面的冲突检测逻辑贴完用一段话解释区间重叠的判断依据。这样既有技术深度又不会被说成代码堆砌。5.3 用接口文档工具反向梳理项目结构如果项目里没有 Swagger可以手动加一个顺便把接口理清楚。加依赖后访问http://localhost:8080/swagger-ui.html就能看到所有接口。dependency groupIdio.springfox/groupId artifactIdspringfox-boot-starter/artifactId version3.0.0/version /dependency逻辑说明Springfox 3.0 适配 Spring Boot 2.6如果项目是 2.7.x 可以直接用。参数上需要在启动类加EnableOpenApi并配一个DocketBean 指定扫描包。加完后所有RestController的接口会自动列出写论文时对着这个列表逐个截图比翻代码快得多。注意 Spring Boot 3.x 要用springdoc-openapiSpringfox 不兼容。5.4 一个验证系统是否真跑通的小习惯我判断一套酒店系统是否真能演示不看登录页而是走一遍完整链路新建一间房 → 用客人账号预订 → 前台确认入住 → 换房 → 退房 → 房态变待打扫 → 保洁确认变空闲。这七步走完数据都对才算跑通。任何一步数据对不上就回到对应的表和接口去查。这个习惯帮我省了很多「演示到一半翻车」的后悔药。希望帮到你。本文还有配套的精品资源点击获取