Java座位预约系统实战：三层架构、并发控制与超时释放

简介：这份资源是《图书馆座位预约管理系统》的完整Java项目源码包，面向学习Java Web开发的学生与初级开发者，用于解决图书馆座位资源分配不均、预约流程繁琐的问题。系统涵盖座位状态查看、在线预约、取消预约、超时自动释放等核心功能，并采用表现层、业务逻辑层与数据访问层的三层架构设计。压缩包共1668个文件，约35.41MB，包含101个java源文件、102个class编译文件、76个jar依赖包，以及312个html、313个css、196个js等前端资源，另有28个jsp页面、46个xml配置、6个db数据库文件与1个sql脚本，完整呈现了从界面到数据持久化的实现链路。目前已有835人学习下载。通过研读源码，读者可掌握JavaFX或Swing界面搭建、JDBC与ORM框架的数据库操作、Spring依赖注入、Maven构建及单元测试等实践技能，是理解Java Web应用开发流程的典型参考案例。

1. 从一堆 .class 文件说起：这套 Java 座位预约系统到底能跑出什么

如果你从压缩包里解压出来的第一眼看到的是一堆.class文件——SeatController.class、BookController.class、LoginController.class、LogAspect.class——而不是熟悉的.java源码，别急着关掉。这恰恰说明这个包是编译过的可运行产物，不是半成品脚手架。图书馆座位预约管理系统要解决的核心问题很具体：读者用手机或电脑查看哪些座位空着、点一下预约、到点没来就自动释放，管理员在后台看使用率、导出日志、管书管话题。它适合两类人：一是想拿一个真实业务场景练手 Java Web 全链路的开发者，二是需要快速搭一套座位管理原型的小型图书馆或自习室运营方。Java 在这里不是随便选的——跨平台、类库全、网络编程成熟，一套代码在 Windows 服务器和 Linux 容器里都能跑，这才是它被拿来当主力语言的实际理由。

2. 三层架构怎么落到代码里：从 Controller 到 JDBC 的完整链路

2.1 表现层、业务层、数据访问层的职责切分

这套系统的骨架是典型的三层架构，但落到具体文件上，很多人第一次看会懵：为什么有SeatController又有BookController，还有ChartController和TopicController？其实每个 Controller 对应一个业务域。SeatController管座位状态查询、预约、取消、超时释放；BookController管图书相关的增删改查；TopicController管话题或公告；ChartController专门负责把统计数据转成图表接口；LogController和LogAspect配合做操作日志的记录与查询。表现层不直接碰数据库，它把请求参数校验完就往下传。

业务逻辑层通常以 Service 类的形式存在，虽然压缩包里没直接列出 Service 的 class 名，但从 Controller 的命名习惯能反推出这套系统是按「Controller → Service → DAO」的调用链走的。LoginController收到登录请求后，会调用对应的 Service 做密码哈希比对和会话生成，而不是在 Controller 里写 SQL。数据访问层通过 JDBC 或轻量 ORM 与数据库通信，常见做法是用 MyBatis 的 Mapper 接口把seat表、user表、reservation表的操作映射成方法调用。

提示：如果你拿到的包只有 class 没有源码，先确认有没有配套的application.properties或jdbc.properties，数据库连接信息通常藏在那里，没有它系统起不来。

2.2 数据库表结构与预约状态机的设计

座位预约最怕的不是并发高，而是状态乱。一张seat表至少要有seat_id、floor、room、status四个字段，status用枚举值表示「空闲 / 已预约 / 使用中 / 维护中」。reservation表则要记录reservation_id、user_id、seat_id、start_time、end_time、status，其中status走一个明确的状态机：RESERVED → CHECKED_IN → COMPLETED，或者RESERVED → TIMEOUT → RELEASED。超时释放的逻辑一般由定时任务扫reservation表里end_time已过且status还是RESERVED的记录，批量更新为RELEASED并把对应seat的status改回空闲。

下面这段 SQL 是建表和状态流转的参考写法，字段类型按 MySQL 习惯给：

-- 座位表：记录物理座位的基本信息和当前状态 CREATE TABLE seat ( seat_id INT PRIMARY KEY AUTO_INCREMENT, floor INT NOT NULL, room VARCHAR(32) NOT NULL, status ENUM('FREE','RESERVED','IN_USE','MAINTENANCE') DEFAULT 'FREE', updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ); -- 预约表：关联用户和座位，记录时间窗口与状态 CREATE TABLE reservation ( reservation_id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, seat_id INT NOT NULL, start_time DATETIME NOT NULL, end_time DATETIME NOT NULL, status ENUM('RESERVED','CHECKED_IN','COMPLETED','TIMEOUT','CANCELLED') DEFAULT 'RESERVED', created_at DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_seat_time (seat_id, start_time, end_time), INDEX idx_user (user_id) );

idx_seat_time这个联合索引很关键，查某个座位在某个时间段是否已被预约时，走索引和全表扫描的差距在数据量上万后非常明显。status用 ENUM 而不是 VARCHAR 是为了防止写入非法状态值，但代价是加新状态要改表结构，小系统够用。

2.3 预约接口的并发控制与超时释放

预约接口最容易被忽略的坑是「两个人同时看到同一个空座位，同时点预约」。如果代码里只是先SELECT查状态再UPDATE，中间没有锁，就会出现超卖。常见做法有两种：一是用数据库行锁，在事务里SELECT ... FOR UPDATE锁住座位行再判断状态；二是用乐观锁，在seat表加version字段，更新时带WHERE version = ?，失败就重试或直接返回「手慢了」。

// 伪代码示意：基于行锁的预约核心逻辑 @Transactional public ReservationResult reserveSeat(int userId, int seatId, LocalDateTime start, LocalDateTime end) { // 1. 锁定座位行，防止并发修改 Seat seat = seatMapper.selectForUpdate(seatId); if (seat.getStatus() != SeatStatus.FREE) { return ReservationResult.fail("座位已被占用"); } // 2. 检查该时间段是否已有预约记录 int conflict = reservationMapper.countConflict(seatId, start, end); if (conflict > 0) { return ReservationResult.fail("该时段已被预约"); } // 3. 写入预约记录并更新座位状态 reservationMapper.insert(userId, seatId, start, end); seatMapper.updateStatus(seatId, SeatStatus.RESERVED); return ReservationResult.success(); }

selectForUpdate对应的 SQL 是SELECT * FROM seat WHERE seat_id = ? FOR UPDATE，它会在事务提交前锁住这一行，其他事务的相同查询会阻塞等待。参数上要注意@Transactional的传播行为和隔离级别，默认的REPEATABLE READ在 MySQL 里配合行锁能挡住大部分并发问题，但如果业务里还有跨座位的批量操作，锁的粒度就要重新评估。

3. 把系统跑起来：环境准备、配置修改与启动验证

3.1 运行环境与依赖版本确认

拿到一个编译好的 Java Web 包，第一件事不是急着java -jar，而是确认它需要什么运行环境。从 Controller 的命名和常见技术栈推断，这套系统大概率是 Spring Boot 或 SSM（Spring + Spring MVC + MyBatis）结构。如果是 Spring Boot，压缩包里应该有一个可执行的 jar 或 war；如果是传统 SSM，就需要外置 Tomcat。先看META-INF/MANIFEST.MF里的Main-Class或Start-Class，能直接判断启动方式。

如果java -version显示的是 17 或 21，而系统编译时用的是 JDK 8，启动时可能报UnsupportedClassVersionError。这不是代码问题，是字节码版本不匹配，换 JDK 8 或 11 就能解决。

3.2 数据库初始化与连接配置

数据库没建好，系统启动时会在连接池初始化阶段直接抛异常。先创建库，再执行建表脚本。如果压缩包里没有.sql文件，就按第 2 章的表结构手动建，至少要有user、seat、reservation三张核心表，user表里记得留一个管理员账号。

# 创建数据库并导入初始化脚本（如果有） mysql -u root -p -e "CREATE DATABASE library_seat DEFAULT CHARACTER SET utf8mb4;" mysql -u root -p library_seat < init.sql # 如果没有 init.sql，手动建表后插入一条管理员记录 mysql -u root -p library_seat -e " INSERT INTO user (username, password, role) VALUES ('admin', SHA2('admin123', 256), 'ADMIN'); "

连接配置通常在application.properties或application.yml里，重点改四个参数：spring.datasource.url、username、password、driver-class-name。MySQL 8.0 的驱动类名是com.mysql.cj.jdbc.Driver，5.7 可以用com.mysql.jdbc.Driver，写错会报ClassNotFoundException。URL 里建议加上useSSL=false&serverTimezone=Asia/Shanghai，否则启动时会有 SSL 警告或时区报错。

3.3 启动与接口连通性验证

配置改完后，Spring Boot 包直接java -jar xxx.jar，传统 war 包丢进 Tomcat 的webapps目录再启动bin/startup.sh。启动日志里看到Started Application in X seconds才算成功。然后别急着开浏览器，先用curl打两个关键接口：登录和座位列表。

# 登录接口：验证认证链路是否通 curl -X POST http://localhost:8080/login \ -H "Content-Type: application/json" \ -d '{"username":"admin","password":"admin123"}' # 座位列表接口：验证数据库查询是否正常 curl http://localhost:8080/seat/list?floor=1

登录返回的 token 或 session id 要记下来，后续预约接口需要在请求头里带上。如果登录返回 401，先查密码哈希算法是否匹配——系统里存的是 SHA-256，你手动插的是明文，那肯定对不上。如果座位列表返回空数组但数据库里明明有数据，检查floor参数是否传对，以及 MyBatis 的mapper-locations配置有没有扫到 XML 文件。

4. 避坑与排查：class 文件、日志切面和图表接口的常见翻车点

4.1 只有 class 没有 java 源码，怎么改配置和排查

现象：解压后全是.class，想改个提示文案或加个字段却无从下手。原因：打包时只保留了编译产物，源码没放进来。解决：先用 JD-GUI 或 CFR 反编译几个核心 Controller，确认类结构和依赖注入方式；配置类的东西一般不在 class 里硬编码，优先找application.properties、application.yml或*.xml。如果连配置文件都没有，反编译DataSourceConfig之类的类，能看到默认连接串。改不了源码就别硬改，把数据库连接指向自己的库、把端口改掉，先跑通再说。

4.2 LogAspect 切面导致启动报错或日志不输出

现象：启动时抛BeanCreationException，指向LogAspect；或者系统能跑但操作日志表一直是空的。原因：切面类依赖了某个 Bean（比如LogService），但那个 Bean 没被扫描到，或者切点表达式写的是execution(* com.xxx.controller.*.*(..))而你的包名不一样。解决：先看启动异常里Caused by后面的具体类名，确认是缺 Bean 还是切点不匹配。如果是包名问题，在@Pointcut里把包路径改成实际的 Controller 包；如果是缺 Bean，检查@ComponentScan的范围是否覆盖了切面所在包。日志不输出但没报错，多半是切点表达式没匹配上任何方法，加一行System.out.println在切面方法里验证是否被调用。

4.3 ChartController 返回数据但前端图表空白

现象：/chart/seatUsage接口返回了 JSON，浏览器 Network 里也能看到数据，但页面上图表就是不出来。原因：常见的是返回的 JSON 结构跟图表库期望的格式对不上。比如 ECharts 要的是{categories: [...], series: [{data: [...]}]}，而接口返回的是[{floor:1, count:5}, ...]。解决：在ChartController里做一层转换，或者在前端加适配逻辑。另一个可能是跨域问题——接口在 8080，前端页面在 3000，浏览器控制台会有 CORS 报错，需要在 Controller 上加@CrossOrigin或全局配置跨域。

4.4 超时释放任务不执行或重复释放

现象：预约时间过了，座位状态还是「已预约」，或者同一个预约被释放了两次导致状态异常。原因：定时任务没配@EnableScheduling，或者 cron 表达式写错；重复释放是因为释放逻辑没加状态判断，UPDATE时没带WHERE status = 'RESERVED'。解决：启动类上加@EnableScheduling，定时方法上加@Scheduled(cron = "0 */5 * * * ?")表示每 5 分钟扫一次。释放 SQL 写成UPDATE reservation SET status='TIMEOUT' WHERE status='RESERVED' AND end_time < NOW()，再根据受影响行数去更新座位状态，这样天然幂等。

4.5 密码哈希与登录会话的隐蔽问题

现象：明明密码输对了，登录就是返回失败；或者登录成功但过一会儿就掉线。原因：密码存储时用了哈希，但比对时用了明文比较；会话超时时间设得太短，或者 session 存在内存里但服务重启了。解决：确认注册和登录用的是同一个哈希算法和盐值，常见做法是SHA-256(password + salt)，salt 存在用户表里。会话方面，如果系统用 JWT，检查 token 的过期时间配置；如果用 session，确认server.servlet.session.timeout的值，默认 30 分钟，测试时可以临时调大。

5. 进阶用法：用日志表和图表接口做座位利用率分析

系统跑通之后，真正有价值的是它积累的数据。LogController和LogAspect记录的操作日志不只是审计用的，把reservation表和log表关联起来，能算出每个楼层、每个时段的座位利用率。我一般会先写一个聚合查询，把原始预约记录按小时和楼层分组，再用ChartController暴露成图表接口。

-- 按楼层和小时统计预约次数，用于热力图 SELECT s.floor, HOUR(r.start_time) AS hour_of_day, COUNT(*) AS reserve_count FROM reservation r JOIN seat s ON r.seat_id = s.seat_id WHERE r.status IN ('COMPLETED', 'CHECKED_IN') AND r.start_time >= DATE_SUB(NOW(), INTERVAL 7 DAY) GROUP BY s.floor, HOUR(r.start_time) ORDER BY s.floor, hour_of_day;

这个查询跑出来的结果直接喂给 ECharts 的热力图组件，X 轴是小时，Y 轴是楼层，颜色深浅代表预约次数。参数上注意INTERVAL 7 DAY控制统计窗口，想看得更长就改数字，但数据量大时记得在start_time上建索引。status过滤掉TIMEOUT和CANCELLED是为了只统计真实使用，不然利用率会被虚高。

另一个实用技巧是给LogAspect加一个「慢接口告警」：在切面里记录每个 Controller 方法的执行耗时，超过 500ms 就写一条 WARN 日志。这样不用额外接监控系统，翻日志就能定位到哪个接口在拖后腿。我习惯在切面里用ThreadLocal存开始时间，@Around里算差值，注意finally里要remove()防止内存泄漏。

从那以后我每次拿到只有 class 的 Java 包，都先反编译看依赖注入和配置读取方式，再决定是改配置跑还是重新搭环境，绝不盲目java -jar。希望帮到你。

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