Javaweb项目完整案例：图书管理系统大二期末大作业实战指南-开发者社区

简介：这是一份面向Java Web初学者与在校学生的图书管理系统实战项目，源自大二上学期期末大作业，适合作为SSM/MyBatis入门练手与课程设计参考。项目围绕书籍、学生、管理员、留言四类实体展开，涵盖借还书日志记录、书籍状态流转（借出、续借、逾期、丢失等）、信誉等级与借阅数量控制等业务逻辑，并完整实现了学生注册、学生登录、管理员登录三条链路，涉及Ajax异步校验、正则验证、Cookie加密记住账号、Session会话管理等常见Web技能点。资源包共59个文件，包含26个Java源码、13个HTML页面、7个XML配置、3个JSP、2个JS脚本以及SQL建表文件等，压缩包约879KB，结构清晰便于按模块阅读。目前已有1915人学习下载，可作为课程设计模板或二次开发起点，帮助读者快速理解前后端交互流程与数据库设计思路。

1. 图书管理系统：大二期末大作业为什么值得当成第一个 Javaweb 练手项目

如果你正在搜「Javaweb 项目完整案例」，大概率会看到一堆 CRUD 后台模板，但图书管理系统是个例外——它天然自带业务闭环：图书入库、借阅、归还、逾期、库存扣减，每个环节都能逼你处理真实的状态流转。大二上学期做这个期末大作业，最大的价值不是交差，而是让你第一次把 JSP/Servlet 或者 Spring Boot + MyBatis 这套东西从「头歌实训答案」里背下来的碎片，拼成一个能跑起来、能演示、能讲清楚数据怎么流动的完整系统。它适合刚学完 Javaweb 基础、想找一个难度可控又不至于太水的项目练手的人。下面我按实际做一遍的顺序，把选型、建表、核心借阅逻辑、前端页面和踩坑点全部拆开讲，你照着能复现，也能看出哪些地方可以按自己课程要求裁剪。

2. 技术选型与数据库设计：先定架构再动手写第一行代码

2.1 为什么大二作业优先选 Spring Boot + MyBatis 而不是纯 JSP/Servlet

很多学校的 Javaweb 课程还在教 JSP + Servlet + JDBC，头歌实训也是这套。但真到期末大作业，纯 Servlet 写下来你会发现光doPost里解析参数、手动关连接、拼 SQL 就能占掉一半代码量，调试全靠System.out.println，一个空指针能查一晚上。Spring Boot 把 Tomcat 内嵌、依赖注入、事务管理都封好了，MyBatis 负责 SQL 映射，你只需要关注业务本身。对于大二上学期，如果课程允许自选框架，我建议直接上 Spring Boot 2.7.x（JDK 8 或 11 都能跑），理由有三个：一是 IDEA 里新建项目就能跑，不用配 Tomcat 和web.xml；二是 MyBatis 的 XML 写 SQL 对新手比 JPA 的自动映射更直观，出问题能直接看到 SQL；三是这套组合就是当前企业里最常见的 Javaweb 技术栈，写进简历不亏。

如果你课程强制要求 JSP + Servlet，也不用慌，把下面讲的表结构和业务逻辑照搬，只是把 Controller 换成 Servlet、把 Service 调用写在doGet/doPost里，前端 JSP 用 EL 表达式取 request 域数据即可。核心的借阅状态机是一样的。

2.2 图书管理系统的四张核心表与字段设计

数据库用 MySQL 5.7 或 8.0 都行，字符集统一utf8mb4。图书管理系统最小可用模型需要四张表：用户表、图书表、借阅记录表、分类表。下面是我一般会用的建表语句，字段名和类型都按实际项目调过，可以直接抄。

-- 用户表：区分管理员和普通读者 CREATE TABLE `user` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `username` VARCHAR(50) NOT NULL UNIQUE COMMENT '登录名', `password` VARCHAR(100) NOT NULL COMMENT '存MD5或BCrypt', `real_name` VARCHAR(50) DEFAULT NULL, `role` TINYINT NOT NULL DEFAULT 0 COMMENT '0读者 1管理员', `status` TINYINT NOT NULL DEFAULT 1 COMMENT '1正常 0禁用', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 图书表：stock是当前可借数量，total_stock是总库存 CREATE TABLE `book` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `isbn` VARCHAR(20) NOT NULL UNIQUE, `title` VARCHAR(200) NOT NULL, `author` VARCHAR(100) DEFAULT NULL, `publisher` VARCHAR(100) DEFAULT NULL, `category_id` INT DEFAULT NULL, `total_stock` INT NOT NULL DEFAULT 1, `stock` INT NOT NULL DEFAULT 1 COMMENT '可借数量', `cover_url` VARCHAR(255) DEFAULT NULL, `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 借阅记录表：status是核心状态字段 CREATE TABLE `borrow_record` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `user_id` INT NOT NULL, `book_id` INT NOT NULL, `borrow_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, `due_time` DATETIME NOT NULL COMMENT '应还时间', `return_time` DATETIME DEFAULT NULL, `status` TINYINT NOT NULL DEFAULT 0 COMMENT '0借出 1已还 2逾期', INDEX `idx_user` (`user_id`), INDEX `idx_book` (`book_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 分类表：给图书归类，前端下拉框用 CREATE TABLE `category` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `name` VARCHAR(50) NOT NULL UNIQUE ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

这里有几个设计点值得说清楚。book表拆了total_stock和stock两个字段，而不是只存一个库存数，原因是管理员补货时改total_stock，借出时只减stock，这样能区分「总共买了多少本」和「现在还能借几本」，做统计报表时不用再关联借阅记录去算。borrow_record的status用 0/1/2 三个值表示借出、已还、逾期，逾期状态不是借出时写死的，而是查询时用due_time和当前时间比较动态判断，或者用一个定时任务每天凌晨刷一次。新手常犯的错是把逾期也当成一个需要手动改的状态，结果还书时逻辑就乱了。

2.3 借阅状态流转：把「借书」这件事拆成三个原子操作

借书这个动作在页面上就是一个按钮，但后端要保证三件事同时成立：库存够、用户没超借阅上限、记录写成功。我一般会把它放在一个@Transactional的 Service 方法里，顺序是：先查用户当前未还数量是否小于阈值（比如 5 本），再查book.stock > 0，然后UPDATE book SET stock = stock - 1 WHERE id = ? AND stock > 0，最后INSERT借阅记录。注意那条 UPDATE 带了AND stock > 0，这是防并发超借的关键——两个请求同时进来，数据库行锁会让第二个请求的stock已经变成 0，更新影响行数为 0，直接抛异常回滚。还书则是反过来：UPDATE book SET stock = stock + 1，同时把记录的status改成 1、return_time填当前时间。这套逻辑写清楚，答辩时老师问「怎么防止两个人同时借最后一本书」你就能答上来。

3. 后端接口与核心业务实现：从登录到借还书的完整代码路径

3.1 用 Spring Boot 搭出可运行的最小骨架

在 IDEA 里新建 Spring Initializr 项目，勾选 Spring Web、MyBatis Framework、MySQL Driver、Lombok 四个依赖，JDK 选 8 或 11。生成后application.yml里配数据库连接和 MyBatis 映射路径：

server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/library?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.library.entity configuration: map-underscore-to-camel-case: true

map-underscore-to-camel-case: true这一行很重要，它让数据库的real_name自动映射到 Java 的realName，省掉一堆resultMap配置。启动类上加@MapperScan("com.example.library.mapper")，否则 MyBatis 找不到接口。跑起来后访问localhost:8080如果看到 Whitelabel 页面就说明环境通了，接下来写业务。

3.2 借书接口的 Service 层实现与事务控制

下面这段是借书的核心 Service 代码，我把它简化到能直接放进项目里跑。参数是用户 id 和图书 id，返回借阅记录 id。

@Service public class BorrowService { @Autowired private BookMapper bookMapper; @Autowired private BorrowRecordMapper borrowRecordMapper; private static final int MAX_BORROW = 5; // 单人最多同时借5本 @Transactional(rollbackFor = Exception.class) public Long borrowBook(Integer userId, Integer bookId) { // 1. 检查当前未还数量 int borrowing = borrowRecordMapper.countByUserAndStatus(userId, 0); if (borrowing >= MAX_BORROW) { throw new RuntimeException("已达最大借阅数量"); } // 2. 扣库存，带 stock > 0 条件防超借 int affected = bookMapper.decreaseStock(bookId); if (affected == 0) { throw new RuntimeException("库存不足"); } // 3. 写借阅记录，应还时间设为30天后 BorrowRecord record = new BorrowRecord(); record.setUserId(userId); record.setBookId(bookId); record.setBorrowTime(new Date()); record.setDueTime(DateUtil.addDays(new Date(), 30)); record.setStatus(0); borrowRecordMapper.insert(record); return record.getId(); } }

对应的 Mapper XML 里，decreaseStock的 SQL 是UPDATE book SET stock = stock - 1 WHERE id = #{bookId} AND stock > 0。这里@Transactional保证了三步要么全成功要么全回滚，rollbackFor = Exception.class让受检异常也回滚，避免只回滚运行时异常的坑。MAX_BORROW设 5 是常见做法，你可以按学校要求改成 3 或 10。还书方法类似，先查记录状态是否为 0，再更新库存和记录，注意还书时也要判断这本书是不是当前用户借的，防止越权操作。

3.3 分页查询与条件搜索：MyBatis 里怎么写动态 SQL

图书列表页需要支持按书名模糊搜、按分类筛选、分页。用 MyBatis 的<where>和<if>标签写动态 SQL 最顺手：

<select id="selectByPage" resultType="com.example.library.entity.Book"> SELECT * FROM book <where> <if test="keyword != null and keyword != ''"> AND (title LIKE CONCAT('%', #{keyword}, '%') OR author LIKE CONCAT('%', #{keyword}, '%')) </if> <if test="categoryId != null"> AND category_id = #{categoryId} </if> </where> ORDER BY id DESC LIMIT #{offset}, #{pageSize} </select>

offset在 Service 里算成(pageNum - 1) * pageSize。这里注意CONCAT('%', #{keyword}, '%')用的是#{}预编译，不是${}拼接，能防 SQL 注入。分页总数用另一个COUNT(*)查询，条件一样但不带 LIMIT。前端传pageNum和pageSize，后端返回一个包含list和total的对象，页面就能渲染分页条。这套写法在「javaweb 项目完整案例 mysql」里几乎通用，换成学生管理系统、商品管理系统也是同样的结构。

4. 前端页面与交互：JSP 和 Thymeleaf 怎么选、怎么快速出效果

4.1 模板引擎选择：Thymeleaf 比 JSP 更适合 Spring Boot 作业

如果课程没强制 JSP，我建议用 Thymeleaf。它和 Spring Boot 集成是官方推荐，HTML 文件直接放src/main/resources/templates下，不用配web.xml，也不用把项目打成 war 包。JSP 在 Spring Boot 里虽然能跑，但要额外引tomcat-embed-jasper依赖、配prefix/suffix，还容易因为内嵌 Tomcat 的版本问题报 404，对新手不友好。Thymeleaf 的语法是th:each、th:text、th:href，学半小时就能上手。如果你学校明确要求 JSP，那就按 JSP 写，把 Controller 返回的 Model 数据用${}取出来，逻辑是一样的。

4.2 图书列表页的 Thymeleaf 循环与分页条实现

下面是一个图书列表页的核心片段，包含搜索框、表格和分页：

<form th:action="@{/book/list}" method="get"> <input type="text" name="keyword" th:value="${keyword}" placeholder="书名或作者"> <select name="categoryId"> <option value="">全部分类</option> <option th:each="c : ${categories}" th:value="${c.id}" th:text="${c.name}" th:selected="${c.id == categoryId}"></option> </select> <button type="submit">搜索</button> </form> <table> <tr th:each="book : ${page.list}"> <td th:text="${book.title}"></td> <td th:text="${book.author}"></td> <td th:text="${book.stock}"></td> <td> <a th:href="@{/borrow/do(bookId=${book.id})}" th:if="${book.stock > 0}">借阅</a> <span th:unless="${book.stock > 0}">已借完</span> </td> </tr> </table> <div> <a th:href="@{/book/list(pageNum=${page.pageNum - 1}, keyword=${keyword})}" th:if="${page.pageNum > 1}">上一页</a> <span th:text="${page.pageNum} + ' / ' + ${page.totalPage}"></span> <a th:href="@{/book/list(pageNum=${page.pageNum + 1}, keyword=${keyword})}" th:if="${page.pageNum < page.totalPage}">下一页</a> </div>

th:selected让搜索后分类下拉框保持选中状态，th:if和th:unless控制借阅按钮和「已借完」的显示切换。分页链接里把keyword也带上，否则翻页后搜索条件就丢了，这是新手很容易忽略的细节。page对象在 Controller 里组装好，包含list、pageNum、totalPage三个属性即可。

4.3 登录拦截与角色区分：一个 HandlerInterceptor 搞定

管理员和读者看到的菜单不一样，但没必要用 Spring Security 那么重。写一个LoginInterceptor实现HandlerInterceptor，在preHandle里从 session 取user，没有就重定向到登录页；再判断请求路径是否以/admin开头，是的话检查user.role == 1，不是就返回 403。注册到WebMvcConfigurer里，排除/login、/css/**、/js/**这些静态资源。这样普通读者访问/admin/book/add会被拦住，管理员功能就隔离出来了。代码量不到 40 行，比配 Spring Security 省事得多，答辩时也能讲清楚权限控制的原理。

5. 避坑与排查：图书管理系统从能跑到能演示之间的五个坎

5.1 中文乱码：数据库、连接串、页面三处都要查

现象是图书标题存进去变成问号，或者页面显示乱码。原因通常有三层：数据库建表时没指定utf8mb4、JDBC 连接串没加characterEncoding=utf8、Thymeleaf 页面没声明<meta charset="UTF-8">。解决方法是建库时CREATE DATABASE library DEFAULT CHARSET utf8mb4，连接串加上useUnicode=true&characterEncoding=utf8，HTML 头部加 meta 声明。三处都对了才不会乱码，只改一处往往还是有问题。

5.2 库存扣成负数：并发下没加行锁条件

现象是压测或多人同时点借阅时，stock变成 -1。原因就是UPDATE book SET stock = stock - 1 WHERE id = ?没带AND stock > 0，两个线程同时读到 stock=1，都执行了扣减。解决办法就是前面 3.2 里写的，UPDATE 语句加上AND stock > 0，再配合@Transactional，影响行数为 0 就抛异常回滚。这是最典型的并发坑，答辩时能主动讲出来是加分项。

5.3 还书后库存没加回去：事务没覆盖到或状态判断漏了

现象是读者还了书，借阅记录显示已还，但图书列表里可借数量还是 0。原因通常是还书方法里只更新了borrow_record的 status，忘了UPDATE book SET stock = stock + 1，或者两个操作没放在同一个事务里，第一个成功第二个失败。解决方法是把还书逻辑也放进@Transactional方法，先查记录 status 是否为 0（防止重复还书），再依次更新记录和库存。重复还书时直接返回「已归还」提示，不要重复加库存。

5.4 分页查询总数不对：COUNT 语句带了 LIMIT 或条件不一致

现象是列表显示 10 条但总页数算出来是 1 页，或者搜索后总数还是全部图书数。原因是 COUNT 查询复用了列表查询的 SQL 但没去掉 LIMIT，或者搜索条件没同步到 COUNT 里。解决办法是单独写一个countByCondition查询，<where>条件和列表查询完全一致，但不带LIMIT和ORDER BY。两个查询的条件参数用同一个对象传，避免手写两遍漏掉字段。

5.5 IDEA 里启动报 404：Mapper 没扫描到或路径配错

现象是项目启动没报错，但访问任何接口都是 404。常见原因有三个：启动类忘了加@MapperScan，Mapper XML 放在java目录下没被编译到classpath，或者mapper-locations路径写成了classpath*:mapper/*.xml但实际文件在resources/mapper下。解决办法是确认@MapperScan注解存在、XML 文件放在src/main/resources/mapper目录、application.yml里mapper-locations: classpath:mapper/*.xml路径匹配。如果还不行，在启动日志里搜Mapped看有没有 SQL 注册成功。

6. 从作业到能讲清楚的项目：加一个逾期计算和统计页

把基本功能跑通之后，想让这个期末大作业在答辩时更有说服力，我一般会加两个小功能。第一个是逾期自动标记：写一个@Scheduled(cron = "0 0 1 * * ?")的定时任务，每天凌晨 1 点把borrow_record里status = 0且due_time < NOW()的记录改成status = 2。这样管理员在借阅列表里能直接筛出逾期记录，不用每次查询都动态算。注意定时任务要在启动类上加@EnableScheduling，cron 表达式六位分别对应秒分时日月周，0 0 1 * * ?就是每天 1 点整执行。

第二个是首页统计卡片：用几条简单的聚合 SQL 查出「图书总数」「今日借出」「逾期未还」三个数字，在 Controller 里塞进 Model，Thymeleaf 页面上用三个th:text显示。SQL 分别是SELECT COUNT(*) FROM book、SELECT COUNT(*) FROM borrow_record WHERE DATE(borrow_time) = CURDATE()、SELECT COUNT(*) FROM borrow_record WHERE status = 2。这三个数字往首页一放，演示时一眼就能看出系统有数据在跑，比空列表有说服力得多。

最后说一个我自己的习惯：每次改完一个功能，先手动把「借书 → 还书 → 再借同一本」这条路径走一遍，确认库存数字对得上再继续写下一个。图书管理系统的坑大多不在代码多难，而在状态流转的细节上，库存和记录对不上就是血泪教训。把这条闭环跑顺了，这个练手项目的价值就到位了。希望帮到你。

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