SSM框架云借阅图书管理系统：从数据库设计到云部署实践

简介：一套基于SSM框架的云借阅图书管理系统完整源码包，内含项目源码和MySQL数据库脚本，面向Java Web初中级学习者和毕业设计者，重点解决图书借阅场景中的用户登录注销、新书推荐、图书借阅与借阅记录管理等核心业务，也适合作为SSM框架整合训练的典型范例。系统后台基于Spring+SpringMVC+MyBatis整合架构，前台采用Bootstrap和jQuery，搭配IntelliJ IDEA 2019、Tomcat 9与JDK 8即可部署运行。压缩包共一百个文件，仅303KB，包含28个Java源文件与编译后的class文件、十组JSP页面、XML配置、CSS/JS静态资源以及数据库SQL脚本，XML承担Spring和MyBatis配置，JSP负责页面展示，CSS/JS完善前端交互，整体按Controller、Service、Mapper分层呈现，便于按图索骥。当前已有12630人学习。通过该项目可掌握用户表、图书信息表、借阅记录表的设计关联，理解借阅状态变更与记录生成流程，既能作为SSM整合开发实训素材，也适合毕业设计做功能扩展或二次开发，并可顺着源码梳理请求处理链路。

1. 为什么用SSM框架做一个云借阅图书管理系统

高校图书馆、企业资料室的借阅流程，往往不是简单的“扫码登记”。读者要先登录，按书名或分类检索，确认库存，然后提交借阅申请；管理员要维护图书上架、处理续借和逾期。把系统部署到云服务器后，读者在任意网络环境都能访问，这就是标题里“云借阅”的实际含义。用SSM框架来做，Spring负责业务对象装配和事务管理，Spring MVC接收页面请求并分发，MyBatis把数据库增删改查收敛到Mapper接口，三层分工明确，是课程设计和中小型系统最常见的选型。

这个标题对应的交付物通常是一个Maven工程加一份初始化数据库的SQL脚本，SSM的三大依赖spring-web、mybatis-spring、mysql-connector-java缺一不可。下面按从零搭建这类系统的固定顺序展开：先设计表和框架配置，再写借阅核心服务，然后落到云部署，最后给几个上线前必须掌握的查错与验证技巧。

2. SSM框架工程搭建与图书数据库设计

从标题的“源码+数据库”来看，数据库脚本是整个系统的起点。真正动手时，我习惯先把表建好，再回头写Java代码。否则Controller写完了，SQL还缺字段，反复改实体类会让人崩溃。先确定数据模型，再搭建工程，这是SSM开发里最不容易返工的顺序。

2.1 图书借阅领域的表结构设计与MySQL建表脚本

常见做法是把用户、图书、借阅记录拆成三张表。用户表只存登录凭证和角色，图书表存书目信息和库存，借阅记录表关联两个主键并保存状态。这样一个读者可以连续借阅多本书，同一本书也能在不同时间段被不同读者借出。

建表脚本如下，适配MySQL 5.7及以上版本：

CREATE TABLE t_user ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, role TINYINT NOT NULL DEFAULT 1 COMMENT '0-管理员，1-普通读者' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE t_book ( id INT AUTO_INCREMENT PRIMARY KEY, book_name VARCHAR(200) NOT NULL, isbn VARCHAR(20) DEFAULT NULL, category VARCHAR(50) DEFAULT NULL, total INT NOT NULL DEFAULT 0, stock INT NOT NULL DEFAULT 0, UNIQUE KEY uk_isbn (isbn) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE t_borrow ( id INT AUTO_INCREMENT PRIMARY KEY, user_id INT NOT NULL, book_id INT NOT NULL, borrow_time DATETIME NOT NULL, due_time DATETIME NOT NULL, return_time DATETIME DEFAULT NULL, status TINYINT NOT NULL DEFAULT 0 COMMENT '0-借出，1-已还，2-逾期', KEY idx_user_id (user_id), KEY idx_book_id (book_id), KEY idx_status (status) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

这里使用 utf8mb4 字符集，避免中文或生僻字写入时报错。t_book 的 isbn 加唯一索引，能防止同一本书重复录入；t_borrow 的 status 加普通索引，等会儿写逾期更新SQL时就不需要全表扫描。如果你后续要扩展图书分类统计，可以单独建 category 表，但课程设计级别的系统用一个字符串字段完全够用。

2.2 Maven工程结构与Spring配置文件要点

SSM框架的工程目录一般分成 controller、service、mapper、entity 四个包，resources 下面放 Spring 和 MyBatis 的 XML 配置。下面是我常用的一套结构：

src/main/java com.example.library controller/ BookController.java, UserController.java service/ BookService.java, BorrowService.java mapper/ BookMapper.java, BorrowMapper.java entity/ User.java, Book.java, Borrow.java src/main/resources mybatis/ mybatis-config.xml mybatis/mapper/ BookMapper.xml, BorrowMapper.xml spring/ spring-dao.xml, spring-service.xml, spring-mvc.xml jdbc.properties src/main/webapp/WEB-INF/web.xml

关键在 spring-dao.xml。数据源使用 Druid，并把 jdbc.properties 里的参数引进来：

<context:property-placeholder location="classpath:jdbc.properties"/> <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"> <property name="driverClassName" value="${jdbc.driver}"/> <property name="url" value="${jdbc.url}"/> <property name="username" value="${jdbc.username}"/> <property name="password" value="${jdbc.password}"/> <property name="initialSize" value="5"/> <property name="maxActive" value="20"/> </bean> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> <property name="mapperLocations" value="classpath:mybatis/mapper/*.xml"/> </bean> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.example.library.mapper"/> </bean>

Druid 的 initialSize 是启动时建立的物理连接数，maxActive 是最大连接数。几十人使用的图书系统，maxActive 设成 20 已经足够，不需要盲目堆到几百。MySQL 服务端的连接数有限，开太多连接反而增加上下文切换开销。MapperScannerConfigurer 会自动扫描 basePackage 下的接口，并把代理对象注册到 Spring 容器，这样 Service 里就能直接 @Autowired 注入 Mapper。

2.3 MyBatis映射与增删改查基础

持久层就是围绕“数据库增删改查”四个动作展开的。Controller 和 Service 不直接写 SQL，都是调用 Mapper 接口。在 XML 里用动态 SQL 处理带条件的图书查询：

<select id="selectByCondition" resultType="com.example.library.entity.Book"> SELECT id, book_name, isbn, category, total, stock FROM t_book <where> <if test="bookName != null and bookName != ''"> AND book_name LIKE CONCAT('%', #{bookName}, '%') </if> <if test="category != null and category != ''"> AND category = #{category} </if> </where> ORDER BY id DESC </select>

<where>标签会自动去掉第一个条件前面的 AND，这是 MyBatis 动态 SQL 最常用的写法。#{bookName}使用预编译参数，能直接避免SQL注入。查询数据库时，不要为了省事在 Service 里手工拼接 SQL，既难维护又容易留下注入面。MyBatis 的 Mapper XML 和 Java 接口只需要保持方法名一致，返回类型由 resultType 或 resultMap 控制，CRUD 的代码量能比 JDBC 原生写法少一半以上。

3. 借阅业务核心模块：从Controller到持久层的完整链路

图书系统的核心不是页面，而是“借书”那一瞬间要同时修改库存和新增借阅记录。这部分最容易出现数据不一致，所以先把登录和查询这类只读模块铺完，再用事务串联借还操作。一个清晰的调用链路应该是：页面提交请求，Controller 接收参数，Service 处理业务，Mapper 执行持久化。

3.1 用户登录与权限拦截

登录接口不需要引入复杂安全框架，用 Spring MVC 的原生 Session 就能撑住。Controller 里校验用户名密码，校验成功后写 session：

@Controller @RequestMapping("/user") public class UserController { @Autowired private UserService userService; @PostMapping("/login") public String login(String username, String password, HttpSession session) { User user = userService.checkLogin(username, password); if (user == null) { return "redirect:/login.jsp?error=1"; } session.setAttribute("loginUser", user); return "redirect:/book/list"; } }

登录逻辑放在 Service 里，Controller 只做参数转发和跳转。如果密码是明文存库，生产环境必须换成 BCrypt 加密，课程设计阶段可以先不做。前台每次访问受保护资源时，通过拦截器检查 session 是否存在用户：

public class LoginInterceptor extends HandlerInterceptorAdapter { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (request.getSession().getAttribute("loginUser") != null) { return true; } response.sendRedirect(request.getContextPath() + "/login.jsp"); return false; } }

然后在 spring-mvc.xml 里注册拦截器：

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

提示：注册拦截器时一定要排除静态资源和登录接口。如果漏了 css、js 的排除路径，页面样式会全部被拦截跳转。

3.2 图书查询与分页的SSM实现

图书列表查询必然用分页。手写 limit 很简单，但需要每次传 pageNum 和 pageSize，还要额外写 count 查询。引入 PageHelper 插件后，业务代码只关心查询本身：

@Service public class BookServiceImpl implements BookService { @Autowired private BookMapper bookMapper; public PageInfo<Book> queryBooks(int pageNum, int pageSize, String bookName) { PageHelper.startPage(pageNum, pageSize); List<Book> list = bookMapper.selectByCondition(bookName); return new PageInfo<>(list); } }

PageHelper.startPage()必须写在查询语句的前一行，中间不能插入任何数据库操作。它的实现原理是使用 ThreadLocal 保存分页参数，MyBatis 执行查询前拦截器自动把 limit 拼接到 SQL 末尾。如果查询方法里还有其他数据库调用，分页参数会被错误消费。建议在 Controller 里拿到 PageInfo 后马上返回，不要跨线程或跨组件传递 pageNum。

3.3 借书与还书的事务控制

借书流程是：先查图书库存，库存大于 0 才允许借出，然后插入一条借阅记录，同时把 t_book 的 stock 减 1。这两步必须在一个数据库事务里，否则会出现“借阅记录插入了但库存没减”的脏数据。Spring 里加@Transactional是最直接的方案：

@Transactional(rollbackFor = Exception.class) public void borrowBook(int userId, int bookId) { Book book = bookMapper.selectById(bookId); if (book == null || book.getStock() <= 0) { throw new BusinessException("库存不足"); } Date now = new Date(); Borrow borrow = new Borrow(); borrow.setUserId(userId); borrow.setBookId(bookId); borrow.setBorrowTime(now); borrow.setDueTime(DateUtils.addDays(now, 30)); borrow.setStatus((byte) 0); bookMapper.reduceStock(bookId); borrowMapper.insert(borrow); }

这里的reduceStock推荐写成UPDATE t_book SET stock = stock - 1 WHERE id = ? AND stock > 0，用数据库行锁保证并发下不会超借。注意@Transactional默认只在遇到 RuntimeException 时回滚，所以 rollbackFor 要显式指定成 Exception.class，否则业务方法声明抛出的受检异常不会触发回滚。还书操作同理，更新借阅状态和归还时间，再执行库存加 1。

3.4 借阅记录与逾期状态更新

逾期判断不需要每时每刻扫库，一个 Daily Task 就够。批量更新 SQL 如下：

UPDATE t_borrow SET status = 2 WHERE status = 0 AND due_time < NOW();

这条 SQL 会把所有到期未还的记录一次性标记为“逾期”。配合 Spring 的 @Scheduled 定时任务，每天固定时间执行一次：

@Component public class OverdueTask { @Autowired private BorrowMapper borrowMapper; @Scheduled(cron = "0 0 1 * * ?") public void refreshOverdue() { borrowMapper.updateOverdueStatus(); } }

cron 表达式表示每天凌晨 1 点执行。别忘了在 Spring 配置文件中开启<task:annotation-driven/>，否则 @Scheduled 不生效。如果系统将来部署了多个实例，同一个定时任务会重复执行，但由于这个更新操作是幂等的，重复执行不会产生严重后果，架构上真正要规避的是库存扣减这类非幂等操作。

4. 云借阅落地：将SSM工程发布到云数据库与云服务器

标题里的“云借阅”不是分布式微服务，它强调的是读者可以脱离局域网访问。常规做法是申请一台云服务器和一个云数据库，把本地 MySQL 数据导入云端，再修改数据源连接配置，打包部署后外网就能访问。这一步是数据库课程设计向真实系统转换的关键环节。

4.1 本地数据库迁移到云数据库的步骤

先用 mysqldump 导出本地数据：

mysqldump -uroot -p --default-character-set=utf8mb4 library > library.sql

然后登录云数据库实例，执行导入：

mysql -h your-cloud-db-host -P 3306 -uroot -p --default-character-set=utf8mb4 library < library.sql

这里的-h只写主机名，端口用-P指定。云数据库通常会提供内网地址和公网地址，如果应用和数据库在同一个 VPC 内，优先使用内网地址，延迟更低且不占用公网流量。导入前检查一下 library.sql 里有没有CREATE DATABASE语句，如果没有，需要先在云数据库控制台创建同名的 library 数据库。

4.2 修改jdbc.properties和连接池参数

本地数据库连接改为云数据库地址，jdbc.properties 如下：

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://your-cloud-db-host:3306/library?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai jdbc.username=your_user jdbc.password=your_password

URL 里的 serverTimezone 参数必须加，MySQL 8.0 以上的连接器会强制校验时区，不设置会直接报Server returns invalid timezone。useSSL=false 能避免本地开发时因为证书校验失败导致的连接超时，生产环境如果云数据库支持 SSL，建议去掉这个参数并启用证书。连接池这边，Druid 的 maxActive 可以下调到 20，initialSize 保持 5，云数据库的并发连接资源同样有限。

4.3 打包发布到云服务器Tomcat

SSM 系统最终打 war 包，放到 Tomcat 的 webapps 目录。用 Maven 打包：

mvn clean package -DskipTests

拿到 target 下的 war 包后，上传到云服务器 Tomcat 的 webapps 目录，启动服务：

bin/startup.sh

启动后立即看日志：

tail -f logs/catalina.out

看到带有Deploying web application archive的日志且没有业务异常，就可以通过公网 IP 加端口访问了。如果 Tomcat 端口和云服务器安全组端口不一致，登录云控制台检查安全组规则是否放行了 8080 或 80 端口。

4.4 云端环境常见排错

第一坑是云数据库的访问白名单。云数据库默认只放行指定 IP，ECS 上连接失败时，先到控制台把 ECS 的公网 IP 或 VPC 网段加入白名单。第二坑是 Tomcat 的端口未放行，云服务器安全组规则和系统防火墙 iptables/firewalld 都要检查。第三坑是请求编码，web.xml 里配置 Spring 的 CharacterEncodingFilter，保证 request 和 response 都是 UTF-8：

<filter> <filter-name>encodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter>

这三处检查完，绝大多数远程访问问题都能定位到。剩余的情况就是数据库账号权限不足，比如只给了 SELECT 没有给 UPDATE，连接数据库的账号也需要单独授权。

5. 借阅系统上线前必查的3个细节：SQL日志、分页插件与数据校验

源码能运行和真正扛住并发是两码事。最后这部分讲三个不用改大结构就能用上的检查技巧，它们直接影响借阅系统上线后的排错效率。

5.1 开启MyBatis SQL日志，快速定位查询数据库的问题

MyBatis 默认不打印 SQL，排错时只能靠猜。在 mybatis-config.xml 里加上一行设置：

<configuration> <settings> <setting name="logImpl" value="STDOUT_LOGGING"/> </settings> </configuration>

这样每个 SQL 和参数都会打印到控制台，能立刻看出?占位符被替换成了什么值。生产环境建议改用 log4j2 输出到独立文件，避免日志量过大刷满磁盘。这条配置在对接云数据库时尤其有用，输入输出参数一旦有误，SQL 日志会直接暴露问题。

5.2 PageHelper分页插件的一个隐藏坑

PageHelper 的 startPage 和查询必须放在同一个线程中，查询结束后最好调用清理方法。如果一个线程先执行了PageHelper.startPage(1, 10)，紧接着执行的不是带 limit 的图书查询，而是借书服务里的下一句 SQL，拦截器会把分页参数应用到那条更新语句上，造成意想不到的数据变更。我习惯在分页查询方法外面包一层 ThreadLocal 清理，确保返回 PageInfo 前分页参数已经被移除，避免串页。

5.3 用一条SQL验证库存和借阅记录是否一致

借还操作结束后，可以用下面这条 SQL 快速核对业务数据：

SELECT b.id, b.book_name, b.stock, b.total - (SELECT COUNT(*) FROM t_borrow WHERE book_id = b.id AND status = 0) AS diff FROM t_book b WHERE b.stock != b.total - (SELECT COUNT(*) FROM t_borrow WHERE book_id = b.id AND status = 0);

如果这条 SQL 返回了数据，说明库存数字和未归还的借阅记录对不上。优先检查借书方法是否缺少事务注解，或者 update 语句的 where 条件没有带上库存大于 0 的约束。这条校验在课程设计答辩时也能成为加分项，它比对着页面数字判断更可靠。

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