基于SSM的图书借阅管理系统：从零搭建到借还书功能实现

简介：这是一套面向计算机相关专业学生与Java后端初学者的SSM图书借阅管理系统毕设项目，适用于毕业设计、课程设计及框架学习等场景。项目以Spring、SpringMVC、Mybatis为核心，配合MySQL、JSP、BootStrap、AJAX实现前后端交互，管理员可完成登录、图书管理（支持上传封面图片）、学生管理、类目管理、借阅与逾期挂失处理，学生端则支持登录注册、信息修改、分类查书与借阅。资源包共341个文件，约372.78MB，包含86个java源码、76个jar依赖、37个xml配置、28个jsp页面及数据库脚本、环境安装包等，并附搭建流程与表结构设计说明，便于快速跑通项目。目前已有3291人学习下载，读者可据此掌握SSM整合思路、数据库设计与借阅业务逻辑，作为毕设参考或二次开发基础均较实用。

1. 基于SSM的图书借阅管理系统：从零搭出一套能跑通借还书的毕设项目

很多同学做毕设时，选题定了“基于SSM的图书借阅管理系统”，打开IDE却不知道从哪下手：Maven依赖拉不下来、Spring和MyBatis的配置文件对不上、Tomcat跑起来一片404。这个标题背后其实是一套非常经典的Java Web分层架构——Spring负责IoC和事务、SpringMVC接管请求路由、MyBatis封装数据库操作，三者拼在一起就是一个完整的图书借阅管理系统。它能解决的核心问题很具体：读者能查书、借书、还书，管理员能管书目、管用户、看借阅记录。适合正在做毕设的本科生，也适合想补一个SSM完整项目经验的后端新手。下面按搭建流程一步步拆，从环境到代码到排错，尽量让你照着能跑起来。

2. 环境与依赖：把SSM三件套的版本锁死

2.1 JDK、Maven、Tomcat、MySQL的版本组合

SSM项目翻车最多的环节不是代码，是版本。我一般会锁一套经过大量项目验证的组合：JDK 8、Maven 3.6.x、Tomcat 8.5、MySQL 5.7。为什么不用JDK 11或17？因为Spring 5.x虽然支持高版本JDK，但配合老版Tomcat和某些MyBatis版本时，反射和字节码处理容易出玄学问题，毕设阶段没必要给自己加难度。MySQL 5.7和8.0的驱动类名不同，5.7用com.mysql.jdbc.Driver，8.0用com.mysql.cj.jdbc.Driver，连接串还要加时区参数，选5.7能少踩一个坑。

2.2 pom.xml里必须声明的依赖

新建Maven Web项目后，第一件事是把pom.xml写对。下面是我常用的依赖清单，版本号直接写死，避免Maven自动选版本导致冲突。

<dependencies> <!-- Spring核心：IoC容器和事务管理 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>5.2.8.RELEASE</version> </dependency> <!-- SpringMVC：处理Web请求 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.2.8.RELEASE</version> </dependency> <!-- Spring JDBC：事务管理器需要 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>5.2.8.RELEASE</version> </dependency> <!-- MyBatis核心 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.6</version> </dependency> <!-- MyBatis与Spring整合包 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>2.0.6</version> </dependency> <!-- MySQL驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.49</version> </dependency> <!-- 数据库连接池 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.2.6</version> </dependency> <!-- Servlet API：provided，Tomcat已提供 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.1.0</version> <scope>provided</scope> </dependency> <!-- JSTL：页面标签 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> </dependencies>

这段配置的逻辑是：Spring上下文和WebMVC分开引入，MyBatis通过mybatis-spring桥接，Druid做连接池。参数上注意scope为provided的Servlet API，打包时不会进war，避免和Tomcat自带包冲突。如果Maven下载慢，在settings.xml里配阿里云镜像，这个不展开。

2.3 目录结构约定

SSM项目对目录结构有隐性要求，放错了Spring扫不到。我一般用这套：

src/main/java/com/library/ controller/ -- SpringMVC控制器 service/ -- 业务接口 service/impl/ -- 业务实现 mapper/ -- MyBatis Mapper接口 entity/ -- 实体类 src/main/resources/ spring-dao.xml -- 数据源与MyBatis配置 spring-service.xml -- Service扫描与事务 spring-mvc.xml -- MVC扫描与视图解析 mybatis-config.xml -- MyBatis全局设置 jdbc.properties -- 数据库连接参数 src/main/webapp/ WEB-INF/web.xml -- 加载Spring容器与MVC WEB-INF/views/ -- JSP页面

controller、service、mapper三个包必须被对应的扫描配置覆盖，否则启动时报“No qualifying bean”或404。这是新手最常见的翻车点之一。

3. 数据库与实体层：图书借阅管理系统的表怎么设计

3.1 四张核心表与借阅状态字段

图书借阅管理系统的数据模型不复杂，但字段设计直接影响后面借还书逻辑。我一般建四张表：book（图书）、reader（读者）、borrow_record（借阅记录）、admin（管理员）。核心是borrow_record，它记录谁借了哪本书、什么时候借、什么时候还、状态如何。

CREATE TABLE book ( id INT PRIMARY KEY AUTO_INCREMENT, isbn VARCHAR(20) NOT NULL UNIQUE, title VARCHAR(100) NOT NULL, author VARCHAR(50), publisher VARCHAR(50), total_count INT DEFAULT 1, -- 馆藏总数 available_count INT DEFAULT 1, -- 可借数量 location VARCHAR(30) -- 馆藏位置 ); CREATE TABLE reader ( id INT PRIMARY KEY AUTO_INCREMENT, card_no VARCHAR(20) NOT NULL UNIQUE, name VARCHAR(30) NOT NULL, phone VARCHAR(15), max_borrow INT DEFAULT 5, -- 最大可借数 status TINYINT DEFAULT 1 -- 1正常 0冻结 ); CREATE TABLE borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT, book_id INT NOT NULL, reader_id INT NOT NULL, borrow_date DATETIME NOT NULL, due_date DATETIME NOT NULL, return_date DATETIME, status TINYINT DEFAULT 0 -- 0借出 1已还 2逾期 );

available_count是关键字段，借书时减一、还书时加一，必须和borrow_record的插入在同一个事务里，否则会出现“记录写了但库存没扣”的数据不一致。status字段用0/1/2表示借出、已还、逾期，比用字符串省空间也好查询。

3.2 实体类与Mapper接口的对应

实体类字段名和表字段用驼峰对应，比如available_count对应availableCount。MyBatis默认不开驼峰映射，需要在mybatis-config.xml里打开。

<configuration> <settings> <!-- 开启驼峰命名自动映射：available_count -> availableCount --> <setting name="mapUnderscoreToCamelCase" value="true"/> <!-- 打印SQL，调试用，上线关掉 --> <setting name="logImpl" value="STDOUT_LOGGING"/> </settings> </configuration>

Mapper接口里定义借阅相关的核心方法：

public interface BorrowRecordMapper { // 插入借阅记录 int insertRecord(BorrowRecord record); // 查询某读者当前未还记录数 int countUnreturnedByReader(@Param("readerId") int readerId); // 更新还书状态 int updateReturn(@Param("id") int id, @Param("returnDate") Date returnDate); }

参数说明：@Param注解用于多参数方法，MyBatis会把它们封装成map，XML里用#{readerId}引用。如果只有一个参数且是对象，可以不加。countUnreturnedByReader用来校验读者是否超过最大可借数，这个校验放在Service层，不要放Controller。

4. 借还书核心逻辑：Service事务与Controller路由

4.1 借书方法的完整实现与事务边界

借书不是简单插一条记录，它包含三个动作：校验读者状态和可借数、扣减图书可借数量、插入借阅记录。这三个动作必须在一个事务里，任何一步失败都要回滚。我一般把事务加在Service实现类的方法上。

@Service public class BorrowServiceImpl implements BorrowService { @Autowired private BookMapper bookMapper; @Autowired private ReaderMapper readerMapper; @Autowired private BorrowRecordMapper borrowRecordMapper; @Override @Transactional(rollbackFor = Exception.class) public String borrowBook(int readerId, int bookId) { // 1. 校验读者状态 Reader reader = readerMapper.selectById(readerId); if (reader == null || reader.getStatus() == 0) { return "读者不存在或已被冻结"; } // 2. 校验当前未还数量 int unreturned = borrowRecordMapper.countUnreturnedByReader(readerId); if (unreturned >= reader.getMaxBorrow()) { return "已达最大可借数量"; } // 3. 校验库存并扣减 Book book = bookMapper.selectById(bookId); if (book == null || book.getAvailableCount() <= 0) { return "图书库存不足"; } bookMapper.decreaseAvailable(bookId); // 4. 插入借阅记录，应还日期为当前时间+30天 BorrowRecord record = new BorrowRecord(); record.setBookId(bookId); record.setReaderId(readerId); record.setBorrowDate(new Date()); record.setDueDate(DateUtils.addDays(new Date(), 30)); record.setStatus(0); borrowRecordMapper.insertRecord(record); return "借阅成功"; } }

逻辑说明：@Transactional的rollbackFor = Exception.class确保任何异常都回滚，默认只回滚RuntimeException，受检异常不回滚，这是血泪经验。decreaseAvailable的SQL要写成UPDATE book SET available_count = available_count - 1 WHERE id = #{id} AND available_count > 0，用数据库行锁保证并发下不会超借。参数上，借期30天是常见设定，可以改成配置项。

4.2 Controller接收请求与返回

Controller只做参数接收和结果封装，不写业务逻辑。

@Controller @RequestMapping("/borrow") public class BorrowController { @Autowired private BorrowService borrowService; @PostMapping("/doBorrow") @ResponseBody public Map<String, Object> doBorrow(@RequestParam("readerId") int readerId, @RequestParam("bookId") int bookId) { Map<String, Object> result = new HashMap<>(); String msg = borrowService.borrowBook(readerId, bookId); result.put("success", "借阅成功".equals(msg)); result.put("message", msg); return result; } }

@ResponseBody返回JSON，前端用Ajax接收。如果要做页面跳转，去掉@ResponseBody返回视图名即可。参数用@RequestParam显式绑定，避免依赖参数名编译保留。

4.3 还书与逾期判断

还书逻辑比借书简单，但要注意逾期状态更新。

@Override @Transactional(rollbackFor = Exception.class) public String returnBook(int recordId) { BorrowRecord record = borrowRecordMapper.selectById(recordId); if (record == null || record.getStatus() == 1) { return "记录不存在或已归还"; } Date now = new Date(); // 超过应还日期则标记逾期，但依然允许归还 int newStatus = now.after(record.getDueDate()) ? 2 : 1; borrowRecordMapper.updateReturn(recordId, now); borrowRecordMapper.updateStatus(recordId, newStatus); bookMapper.increaseAvailable(record.getBookId()); return "归还成功"; }

这里updateReturn和updateStatus可以合并成一条SQL，分开写是为了演示状态字段的独立更新。increaseAvailable要和还书在同一事务，否则库存对不上。

5. 避坑与排查：SSM整合最常翻车的五个地方

5.1 启动报NoClassDefFoundError或ClassNotFoundException

现象：Tomcat启动时抛java.lang.NoClassDefFoundError: org/springframework/context/ApplicationContext。原因通常是Maven依赖没有打进war包，或者provided范围用错了。解决：在IDEA里检查Project Structure的Artifacts，确认lib目录下包含所有Spring和MyBatis的jar；执行mvn clean package后解压war看WEB-INF/lib是否完整。如果用了provided的包被其他代码引用，改成默认scope。

5.2 404：DispatcherServlet映射配错

现象：访问/borrow/doBorrow返回404，控制台无报错。原因一般是web.xml里DispatcherServlet的url-pattern配成了/*而不是/，或者spring-mvc.xml的组件扫描包路径写错。解决：url-pattern用/，让静态资源走默认Servlet；<context:component-scan base-package="com.library.controller"/>只扫controller包，不要扫全包导致事务配置重复加载。

5.3 事务不生效：Service没被Spring管理

现象：借书时库存扣了但记录没插入，或者异常后数据没回滚。原因通常是Service实现类没加@Service，或者事务注解加在了Controller上。解决：确认Service实现类有@Service，且spring-service.xml里开启了<tx:annotation-driven transaction-manager="transactionManager"/>，事务管理器注入的是同一个数据源。另外，方法必须是public，内部调用不走代理。

5.4 MyBatis报Invalid bound statement

现象：调用Mapper方法时抛org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)。原因是Mapper XML的namespace和接口全限定名不一致，或者XML没放在resources的对应目录下。解决：确保mapper-locations配置为classpath:mapper/*.xml，XML里<mapper namespace="com.library.mapper.BookMapper">和接口包名完全一致，方法id和接口方法名一致。

5.5 中文乱码：从数据库到页面全链路

现象：页面显示图书名称为问号。原因可能出在数据库字符集、连接串、JSP页面编码三处。解决：建库时用utf8mb4，连接串加useUnicode=true&characterEncoding=utf8，JSP页面顶部加<%@ page contentType="text/html;charset=UTF-8" language="java" %>，web.xml里配CharacterEncodingFilter。四处都对了才不会乱码。

6. 进阶技巧：用拦截器做登录校验与借阅统计

6.1 登录拦截器的实现与放行规则

毕设答辩时老师常问“没登录能不能直接访问借书接口”，加一个拦截器就能堵住。实现HandlerInterceptor，在preHandle里检查session。

public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行登录页和登录接口 String uri = request.getRequestURI(); if (uri.contains("/login") || uri.contains("/doLogin")) { return true; } Object admin = request.getSession().getAttribute("admin"); if (admin == null) { response.sendRedirect(request.getContextPath() + "/login"); return false; } return true; } }

在spring-mvc.xml里注册：

<mvc:interceptors> <mvc:interceptor> <mvc:mapping path="/**"/> <mvc:exclude-mapping path="/login"/> <mvc:exclude-mapping path="/doLogin"/> <mvc:exclude-mapping path="/static/**"/> <bean class="com.library.interceptor.LoginInterceptor"/> </mvc:interceptor> </mvc:interceptors>

放行规则要包含登录接口和静态资源，否则登录页的CSS和JS也会被拦。exclude-mapping的路径要和实际请求匹配，注意contextPath的影响。

6.2 借阅排行榜的SQL写法

答辩时加一个“借阅排行榜”能加分。用一条聚合SQL搞定：

SELECT b.title, b.author, COUNT(r.id) AS borrow_count FROM borrow_record r JOIN book b ON r.book_id = b.id GROUP BY r.book_id ORDER BY borrow_count DESC LIMIT 10;

对应Mapper方法返回List<Map<String, Object>>，Service直接透传，Controller放进Model。注意GROUP BY在MySQL 5.7默认的ONLY_FULL_GROUP_BY模式下，SELECT的字段必须在GROUP BY里或聚合函数内，所以b.title和b.author要么加进GROUP BY，要么用ANY_VALUE()包起来。我一般把b.title, b.author都加进GROUP BY，简单直接。

6.3 一个我踩过的坑：日期格式化

借阅记录列表里borrow_date显示成Mon Jan 01 00:00:00 CST 2024这种格式，前端没法看。解决是在实体类的日期字段上加@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")，或者在JSP里用<fmt:formatDate>。我习惯在实体类上加注解，因为返回JSON时也统一。时区必须写GMT+8，否则会差8小时，这个坑我调了一下午才找到。

做毕设项目最怕的不是代码难，是环境配不通、版本对不上、报错看不懂。我自己的习惯是每配好一个环节就立刻跑一次，不要等全部写完再启动，否则出了问题不知道是哪一层。SSM这套东西虽然老，但把图书借阅管理系统跑通一遍，Spring的IoC和AOP、MyBatis的映射、事务的边界这些概念就都落地了。希望帮到你。

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