资讯详情

深入了解 · 专业解读

SpringBoot与若依框架实战：快速构建图书管理系统全流程指南

发布时间：2026/9/1 15:05:02
SpringBoot与若依框架实战：快速构建图书管理系统全流程指南 最近在帮朋友做一个图书管理的小项目原本想从零开始搭建但考虑到时间成本和功能完整性最终选择了基于若依RuoYi这个优秀的开源后台管理系统进行二次开发。结合SpringBoot的快速开发能力整个项目从环境搭建到核心功能上线效率提升非常明显。今天就把这个“基于SpringBoot若依的图书管理系统”的完整实战过程整理出来内容涵盖环境准备、项目导入、数据库设计、代码生成、业务定制、前端调整以及部署上线全流程。无论你是想快速完成一个毕业设计还是为企业内部搭建一个轻量级的管理系统这套方案都能让你直接复用少走很多弯路。1. 项目背景与核心技术栈介绍在开始动手之前我们有必要了解一下为什么选择这个技术组合以及它能解决什么问题。1.1 为什么是 SpringBoot 若依SpringBoot大家都很熟悉了它极大地简化了 Spring 应用的初始搭建和开发过程通过自动配置和起步依赖让我们能快速构建独立、生产级的应用。对于图书管理系统这类典型的 Web 应用SpringBoot 提供了完善的 Web、数据访问、安全等模块支持。而若依RuoYi是一个基于 SpringBoot 的权限管理系统它并非一个简单的脚手架而是一个功能完备的后台管理框架。它已经内置了用户管理、角色权限、菜单管理、部门管理、操作日志、代码生成器等后台系统必备的核心模块。这意味着我们不需要从零开始写用户登录、权限校验这些通用且繁琐的功能可以直接在其强大的基础上专注于图书管理这个核心业务的开发。两者的结合优势快速启动利用若依的现成框架省去基础模块开发时间。规范统一若依提供了清晰的前后端分离架构和代码规范。功能复用直接使用其代码生成器能一键生成单表的增删改查前后端代码。易于扩展基于 SpringBoot 和若依的模块化设计新增业务功能非常方便。1.2 图书管理系统核心功能规划我们的目标是一个具备基础 CRUD 和简单业务流程的管理系统主要功能模块包括权限管理用户、角色、菜单权限复用若依。图书信息管理图书的增、删、改、查包括书名、作者、ISBN、出版社、分类、库存数量、价格等字段。图书分类管理对图书进行分类如计算机、文学、历史等。借阅管理记录用户的借书、还书操作包括借阅人、图书、借出时间、应还时间、实际归还时间、状态借出/在库/超期等。读者管理管理系统的使用者读者信息。数据统计简单的数据看板如图书总量、借阅排行、库存预警等。2. 环境准备与项目初始化工欲善其事必先利其器。我们先来准备好开发环境并获取若依的基础项目。2.1 开发环境清单请确保你的本地开发环境已安装以下软件版本号以稳定为主无需追求最新环境/工具推荐版本说明JDK1.8 或 11SpringBoot 2.x 对 JDK 8 兼容性最好。若依官方推荐 JDK 1.8。Maven3.6用于项目依赖管理和构建。MySQL5.7 或 8.0项目主数据库。本文使用 MySQL 8.0。Redis5.0若依用其做缓存和会话管理。必须安装。IDEIntelliJ IDEA社区版或旗舰版均可对 SpringBoot 支持好。Node.js14运行前端项目所需。Git最新版用于克隆项目代码。2.2 获取若依前后端分离版本若依提供了多种版本单体、前后端分离、微服务。我们选择最流行的前后端分离版本后端是 SpringBoot前端是 Vue3。访问若依官方仓库在 Gitee 或 GitHub 上搜索 “RuoYi-Vue”。克隆后端项目git clone https://gitee.com/y_project/RuoYi-Vue.git克隆前端项目可选后续部署需要git clone https://gitee.com/y_project/RuoYi-Vue-UI.git我们主要进行后端开发前端项目用于界面展示和联调。2.3 导入项目与基础配置使用 IDEA 打开后端项目打开RuoYi-Vue文件夹。配置 Maven确保 IDEA 使用了正确的 Maven 设置和仓库。修改数据库配置找到ruoyi-admin模块下的配置文件/src/main/resources/application-druid.yml。# 数据源配置 spring: datasource: type: com.alibaba.druid.pool.DruidDataSource driverClassName: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/ry_vue?useUnicodetruecharacterEncodingutf8zeroDateTimeBehaviorconvertToNulluseSSLtrueserverTimezoneGMT%2B8 username: root password: your_password # 改为你的MySQL密码注意这里连接的是若依的默认数据库ry_vue我们需要先创建它。创建数据库并初始化-- 登录MySQL后执行 CREATE DATABASE IF NOT EXISTS ry_vue DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE ry_vue; -- 执行项目sql文件夹下的初始化脚本 -- 通常位于 /ruoyi-admin/src/main/resources/sql/ 目录下有多个版本选择对应的如 quartz.sql, ry_2024xxxx.sql -- 在MySQL客户端中 source 这些sql文件或者用IDE的数据库工具导入。配置 Redis修改application.yml中的 Redis 配置。# redis 配置 redis: # 地址 host: localhost # 端口默认为6379 port: 6379 # 数据库索引 database: 0 # 密码 password: # 连接超时时间 timeout: 10s启动后端项目找到RuoYiApplication主类直接运行。访问http://localhost:8080应该能看到后端 API 文档Swagger页面说明启动成功。3. 数据库设计与表结构创建在若依的ry_vue数据库中我们需要新增图书管理相关的表。3.1 核心表结构设计我们设计四张核心表book_type图书分类、book_info图书信息、reader_info读者信息、book_borrow借阅记录。表之间通过外键关联。-- 1. 图书分类表 CREATE TABLE book_type ( type_id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 分类ID, type_name varchar(100) NOT NULL COMMENT 分类名称, order_num int(4) DEFAULT 0 COMMENT 显示顺序, status char(1) DEFAULT 0 COMMENT 状态0正常 1停用, create_by varchar(64) DEFAULT COMMENT 创建者, create_time datetime DEFAULT NULL COMMENT 创建时间, update_by varchar(64) DEFAULT COMMENT 更新者, update_time datetime DEFAULT NULL COMMENT 更新时间, remark varchar(500) DEFAULT NULL COMMENT 备注, PRIMARY KEY (type_id) ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4 COMMENT图书分类表; -- 2. 图书信息表 CREATE TABLE book_info ( book_id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 图书ID, book_name varchar(200) NOT NULL COMMENT 图书名称, author varchar(100) DEFAULT NULL COMMENT 作者, isbn varchar(50) DEFAULT NULL COMMENT ISBN编号, publisher varchar(100) DEFAULT NULL COMMENT 出版社, type_id bigint(20) DEFAULT NULL COMMENT 分类ID, price decimal(10,2) DEFAULT NULL COMMENT 价格, total_count int(11) NOT NULL DEFAULT 0 COMMENT 总库存, current_count int(11) NOT NULL DEFAULT 0 COMMENT 当前可借库存, location varchar(200) DEFAULT NULL COMMENT 存放位置, status char(1) DEFAULT 0 COMMENT 状态0在库 1借出 2维护, create_by varchar(64) DEFAULT COMMENT 创建者, create_time datetime DEFAULT NULL COMMENT 创建时间, update_by varchar(64) DEFAULT COMMENT 更新者, update_time datetime DEFAULT NULL COMMENT 更新时间, remark varchar(500) DEFAULT NULL COMMENT 备注, PRIMARY KEY (book_id), KEY idx_type_id (type_id), CONSTRAINT fk_book_type FOREIGN KEY (type_id) REFERENCES book_type (type_id) ON DELETE SET NULL ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4 COMMENT图书信息表; -- 3. 读者信息表 (可以复用若依的 sys_user这里为了清晰单独建表实际可关联) CREATE TABLE reader_info ( reader_id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 读者ID, reader_name varchar(50) NOT NULL COMMENT 读者姓名, gender char(1) DEFAULT 0 COMMENT 性别0男 1女 2未知, phone varchar(11) DEFAULT NULL COMMENT 手机号码, email varchar(50) DEFAULT NULL COMMENT 邮箱, id_card varchar(18) DEFAULT NULL COMMENT 身份证号, max_borrow int(11) DEFAULT 5 COMMENT 最大可借数量, status char(1) DEFAULT 0 COMMENT 状态0正常 1锁定, create_by varchar(64) DEFAULT COMMENT 创建者, create_time datetime DEFAULT NULL COMMENT 创建时间, update_by varchar(64) DEFAULT COMMENT 更新者, update_time datetime DEFAULT NULL COMMENT 更新时间, remark varchar(500) DEFAULT NULL COMMENT 备注, PRIMARY KEY (reader_id) ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4 COMMENT读者信息表; -- 4. 图书借阅记录表 CREATE TABLE book_borrow ( borrow_id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 借阅ID, reader_id bigint(20) NOT NULL COMMENT 读者ID, book_id bigint(20) NOT NULL COMMENT 图书ID, borrow_time datetime NOT NULL COMMENT 借出时间, due_time datetime NOT NULL COMMENT 应还时间, return_time datetime DEFAULT NULL COMMENT 实际归还时间, status char(1) DEFAULT 0 COMMENT 状态0借出中 1已归还 2超期未还, create_by varchar(64) DEFAULT COMMENT 创建者, create_time datetime DEFAULT NULL COMMENT 创建时间, update_by varchar(64) DEFAULT COMMENT 更新者, update_time datetime DEFAULT NULL COMMENT 更新时间, remark varchar(500) DEFAULT NULL COMMENT 备注, PRIMARY KEY (borrow_id), KEY idx_reader_id (reader_id), KEY idx_book_id (book_id), CONSTRAINT fk_borrow_reader FOREIGN KEY (reader_id) REFERENCES reader_info (reader_id), CONSTRAINT fk_borrow_book FOREIGN KEY (book_id) REFERENCES book_info (book_id) ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4 COMMENT图书借阅记录表;设计要点说明字段规范遵循若依的字段命名习惯如create_by,create_time,update_by,update_time,status,remark便于框架自动填充。库存管理book_info表设计了total_count总库存和current_count当前可借库存。借书时current_count减1还书时加1。状态枚举使用char(1)存储状态‘0’,‘1’,‘2’等代表不同状态在代码中定义枚举类。外键约束虽然生产环境有时会避免使用数据库外键但在学习和小型项目中使用外键可以保证数据一致性。这里添加了外键约束。4. 使用若依代码生成器快速构建CRUD这是若依框架最强大的功能之一能根据数据库表一键生成包括实体类、Mapper、Service、Controller以及前端Vue页面在内的所有基础代码。4.1 配置代码生成器启动项目使用默认账号admin/ 密码admin123登录系统。进入系统菜单系统工具-代码生成。导入需要生成的表点击“导入”按钮选择我们刚创建的四张表 (book_type,book_info,reader_info,book_borrow)。编辑每张表的生成信息基本信息设置生成模块名如library、业务名如bookType、类名如BookType、功能作者。字段信息检查并确认每个字段的 Java 属性名、类型String, Integer, BigDecimal, Date等以及是否在列表中显示、是否为查询条件、表单显示类型输入框、下拉框、日期控件等。例如book_info表的type_id字段在生成前端表单时应设置为“下拉框”并关联book_type表的数据。status字段通常设置为“单选框”或“下拉框”并配置字典值如0正常,1停用。生成信息配置生成模板默认即可设置前端路径如vue和包路径如com.ruoyi.library。4.2 生成与导入代码在每张表的编辑页面配置完成后保存。在代码生成主列表勾选要生成的所有表点击“生成代码”。下载生成的代码压缩包并解压。后端代码将解压后的java文件夹下的内容复制到后端项目的对应包路径下如com.ruoyi.library。将resources文件夹下的mapper文件复制到项目的resources/mapper目录下。前端代码将解压后的vue文件夹下的.vue文件复制到前端项目的对应目录通常是/src/views/下的模块文件夹如library/bookType。重启后端服务因为新增了RestController等组件需要重启应用。配置菜单权限进入若依后台系统管理-菜单管理。在合适的目录下如可以新建一个“图书管理”目录新建菜单。菜单类型选择“菜单”组件路径填写前端生成代码中.vue文件的路径如library/bookType/index。权限标识填写生成代码中 Controller 的请求映射前缀如library:bookType:list。为不同的角色如管理员分配这些新菜单的权限。完成以上步骤后刷新页面你应该能在侧边栏看到“图书分类管理”、“图书信息管理”等菜单并且已经具备了基础的列表查询、新增、修改、删除、导出功能。这就是若依代码生成器的威力5. 核心业务逻辑定制开发代码生成器提供了骨架但复杂的业务逻辑需要我们自己实现。以借书和还书功能为例。5.1 借书业务逻辑实现借书不是简单的插入一条book_borrow记录它需要一系列业务校验和状态更新。创建 Service 方法在BookBorrowService接口和其实现类BookBorrowServiceImpl中新增一个借书方法。// BookBorrowService.java public interface BookBorrowService { // ... 其他生成的CRUD方法 /** * 借阅图书 * param borrow 借阅信息 * return 结果 */ AjaxResult borrowBook(BookBorrow borrow); }// BookBorrowServiceImpl.java Service public class BookBorrowServiceImpl implements BookBorrowService { Autowired private BookBorrowMapper bookBorrowMapper; Autowired private BookInfoMapper bookInfoMapper; Autowired private ReaderInfoMapper readerInfoMapper; Override Transactional(rollbackFor Exception.class) // 重要开启事务 public AjaxResult borrowBook(BookBorrow borrow) { // 1. 参数校验 if (borrow.getReaderId() null || borrow.getBookId() null) { return AjaxResult.error(读者或图书信息不能为空); } // 2. 校验读者状态和可借数量 ReaderInfo reader readerInfoMapper.selectReaderInfoById(borrow.getReaderId()); if (reader null) { return AjaxResult.error(读者不存在); } if (1.equals(reader.getStatus())) { return AjaxResult.error(读者账户已被锁定无法借书); } // 查询该读者当前借出未还的数量 Long borrowingCount bookBorrowMapper.countBorrowingByReaderId(borrow.getReaderId()); if (borrowingCount reader.getMaxBorrow()) { return AjaxResult.error(已达到最大可借阅数量); } // 3. 校验图书库存和状态 BookInfo book bookInfoMapper.selectBookInfoById(borrow.getBookId()); if (book null) { return AjaxResult.error(图书不存在); } if (book.getCurrentCount() 0) { return AjaxResult.error(该图书暂无库存); } if (!0.equals(book.getStatus())) { return AjaxResult.error(图书状态不可借阅); } // 4. 更新图书库存和状态 book.setCurrentCount(book.getCurrentCount() - 1); if (book.getCurrentCount() 0) { book.setStatus(1); // 状态改为借出 } bookInfoMapper.updateBookInfo(book); // 5. 设置借阅记录信息 borrow.setBorrowTime(new Date()); // 借出时间 // 计算应还时间例如30天后 Calendar calendar Calendar.getInstance(); calendar.setTime(borrow.getBorrowTime()); calendar.add(Calendar.DAY_OF_MONTH, 30); borrow.setDueTime(calendar.getTime()); borrow.setStatus(0); // 状态借出中 // 若依框架会自动填充 createBy, createTime 等字段 // 6. 插入借阅记录 bookBorrowMapper.insertBookBorrow(borrow); return AjaxResult.success(借阅成功); } }创建 Controller 接口在BookBorrowController中暴露借书API。RestController RequestMapping(/library/borrow) public class BookBorrowController extends BaseController { Autowired private BookBorrowService bookBorrowService; PostMapping(/borrowBook) public AjaxResult borrowBook(RequestBody BookBorrow borrow) { return bookBorrowService.borrowBook(borrow); } }补充 Mapper 查询需要在BookBorrowMapper.xml中新增一个统计查询。!-- 统计读者未归还的借阅数量 -- select idcountBorrowingByReaderId parameterTypeLong resultTypeLong SELECT count(1) FROM book_borrow WHERE reader_id #{readerId} AND status in (0, 2) -- 借出中或超期未还 /select5.2 还书业务逻辑实现还书逻辑同样需要更新图书状态和借阅记录状态。// BookBorrowServiceImpl.java 中新增方法 Override Transactional(rollbackFor Exception.class) public AjaxResult returnBook(Long borrowId) { // 1. 查询借阅记录 BookBorrow borrow bookBorrowMapper.selectBookBorrowById(borrowId); if (borrow null) { return AjaxResult.error(借阅记录不存在); } if (!0.equals(borrow.getStatus())) { return AjaxResult.error(该图书已归还或状态异常); } // 2. 查询对应图书 BookInfo book bookInfoMapper.selectBookInfoById(borrow.getBookId()); if (book null) { return AjaxResult.error(对应图书不存在); } // 3. 更新图书库存和状态 book.setCurrentCount(book.getCurrentCount() 1); // 如果当前库存从0变为1状态改回在库 if (book.getCurrentCount() 1) { book.setStatus(0); } bookInfoMapper.updateBookInfo(book); // 4. 更新借阅记录 borrow.setReturnTime(new Date()); // 实际归还时间 // 判断是否超期 if (borrow.getReturnTime().after(borrow.getDueTime())) { borrow.setStatus(2); // 超期归还 (可根据需要记录罚金等) } else { borrow.setStatus(1); // 正常归还 } bookBorrowMapper.updateBookBorrow(borrow); return AjaxResult.success(归还成功); }5.3 前端页面调用后端API在前端生成的bookBorrow.vue页面中我们需要添加“借书”和“还书”的按钮和对话框。在列表操作列添加“还书”按钮仅当状态为“借出中”时显示。el-table-column label操作 aligncenter class-namesmall-padding fixed-width template slot-scopescope el-button sizemini typetext iconel-icon-edit clickhandleUpdate(scope.row) v-hasPermi[library:borrow:edit] 修改/el-button !-- 还书按钮 -- el-button sizemini typetext iconel-icon-circle-check clickhandleReturn(scope.row) v-hasPermi[library:borrow:return] v-ifscope.row.status 0 !-- 状态为借出中 -- 还书/el-button /template /el-table-column在 methods 中实现handleReturn方法。// 还书操作 handleReturn(row) { this.$modal.confirm(确认归还图书《 row.bookName 》吗).then(() { returnBook(row.borrowId).then(response { this.$modal.msgSuccess(归还成功); this.getList(); // 刷新列表 }); }).catch(() {}); },在api文件夹下的bookBorrow.js中新增returnBook函数。// 还书 export function returnBook(borrowId) { return request({ url: /library/borrow/returnBook/ borrowId, method: post }) }同理可以创建一个独立的“借书”页面或对话框调用我们写的borrowBookAPI。6. 常见问题与排查思路FAQ在开发过程中你可能会遇到以下典型问题这里提供排查思路。问题现象可能原因排查步骤与解决方案代码生成后菜单不显示或页面4041. 菜单组件路径配置错误。2. 前端路由未注册。3. 权限未分配。1. 检查菜单管理中的“组件路径”是否与前端.vue文件路径一致。2. 在前端项目的路由文件如router/index.js中检查是否自动或手动添加了该模块的路由。3. 检查角色管理是否为当前登录角色分配了该菜单权限。若依框架启动报错连接数据库/Redis失败1. 数据库/Redis服务未启动。2.application.yml配置错误。3. 驱动包版本不匹配。1. 用命令行或工具确认 MySQL 和 Redis 服务是否正常运行。2. 仔细核对application-druid.yml和application.yml中的连接信息主机、端口、密码、数据库名。3. 检查pom.xml中 MySQL Connector 和 Redis 客户端的版本。前端调用后端API报4041. 后端 Controller 请求路径 (RequestMapping) 与前端请求 URL 不匹配。2. 后端服务未重启新增的 Controller 未加载。3. 跨域问题开发环境常见。1. 对比浏览器开发者工具 Network 中的请求 URL 和后端 Controller 类的路径。2. 重启后端 SpringBoot 应用。3. 若依已配置跨域检查配置是否被覆盖。开发时也可暂时关闭浏览器安全策略测试。插入或更新数据时create_by等字段为null若依的自动填充功能未生效。确保你的实体类继承了BaseEntity并且字段名与基类中定义的一致。检查application.yml中是否配置了mybatis-plus的全局填充策略。使用代码生成器时下拉框数据不显示未配置字典数据或关联表查询。1. 对于固定枚举如状态在系统管理的“字典管理”中创建字典类型和字典数据然后在代码生成器字段配置中选择该字典。2. 对于关联表如图书分类需要在生成后手动修改前端组件使用select组件并调用分类查询接口获取数据。打包成Jar后运行报错提示找不到主清单Maven 打包插件配置问题。在父工程或ruoyi-admin模块的pom.xml中确保有spring-boot-maven-plugin插件并且指定了mainClass。若依原项目已配置检查是否被修改。7. 项目优化与生产部署建议完成基础功能后可以考虑以下优化点让系统更健壮、更专业。7.1 后端优化建议接口幂等性对于借书、还书这类重要操作考虑使用唯一业务流水号或Token机制防止重复提交。数据校验在 Controller 层使用Validated注解配合 JSR-303 校验注解如NotNull,Size对入参进行校验。全局异常处理若依已有GlobalExceptionHandler可以在此统一处理业务异常返回友好的错误信息。分页优化对于大数据量的表如借阅记录确保分页查询使用索引避免深分页问题。缓存应用将不常变动的数据如图书分类放入 Redis 缓存减少数据库压力。定时任务使用若依集成的 Quartz 或 Spring Task创建定时任务每天检查超期未还的借阅记录并更新状态或发送提醒。7.2 前端优化建议表单验证充分利用 Element UI 的表单验证规则在前端进行初步校验。按钮防抖给提交按钮添加loading状态或防抖处理防止用户连续点击。数据字典将状态等枚举值在前端也定义为常量或从字典接口获取避免硬编码。组件复用将通用的组件如图书选择器、读者选择器抽离出来提高代码复用率。7.3 部署上线后端打包在项目根目录执行mvn clean package -DskipTests在ruoyi-admin/target目录下生成可执行的jar文件。前端构建进入前端项目目录执行npm run build:prod生成静态资源文件在dist文件夹。环境配置准备生产环境的application-prod.yml配置生产数据库、Redis地址、日志路径等。部署方式传统部署将jar包和前端dist文件夹放到服务器。使用 Nginx 代理前端请求到dist反向代理 API 请求到后端jar应用默认端口8080。使用nohup或 systemd 守护进程运行jar包。Docker 部署推荐编写Dockerfile和docker-compose.yml将 MySQL、Redis、后端应用、Nginx 容器化部署管理更方便。这也是当前热门的部署方式。安全加固修改默认密码检查若依的安全配置如 XSS过滤、SQL防注入关闭不必要的接口如Swagger在生产环境应禁用。通过以上步骤一个功能相对完整、架构清晰的基于 SpringBoot 和若依的图书管理系统就搭建完成了。这个项目不仅实现了业务功能更重要的是展示了如何在一个成熟的开源框架上进行高效的二次开发。你可以在此基础上继续扩展比如加入扫码借书、数据报表分析、微信小程序端等使其成为一个更强大的综合管理系统。

相关新闻