简介这份资源是面向高校计算机专业学生与Java初学者的一套课程设计完整实践包围绕电子图书馆的图书借阅管理场景展开帮助读者在真实项目中理解Java Web开发流程。系统区分普通用户与管理员两类角色普通用户可浏览、检索图书并查看借阅记录管理员则能管理用户信息与图书库存技术栈采用Maven构建、Mybatis持久层与MySQL数据库覆盖需求分析、数据库设计到接口实现的多个环节。压缩包共231个文件约5.63MB包含30个java源码、19个jsp页面、48个xml配置、21个js脚本以及css、图片、字体等前端资源另附sql建库脚本与说明文档目录结构清晰便于按模块阅读与二次开发。目前已有54人学习下载适合作为课程设计参考模板也可用于巩固Java编程、数据库设计与软件工程知识。1. 电子图书馆课程设计一份能跑起来的 Java 项目该长什么样很多同学做 Java 课程设计时卡住的地方从来不是「不会写代码」而是不知道一个完整的、能演示、能答辩的项目到底该包含哪些东西。电子图书馆这个题目每年被选中的概率极高原因很直接业务场景清晰图书、用户、借阅、归还数据库表关系典型一对多、多对多都有前后端交互完整还天然适合塞进权限控制和分页查询这些加分项。但真正动手时你会发现网上搜到的「java课程设计案例源码」要么只有一堆散装类文件没有数据库脚本要么跑起来报一堆环境错误要么文档只有几页截图没有部署说明。这篇笔记要解决的就是这件事把「电子图书馆项目源码附带文档」拆成一条可复现的路径——从技术选型、数据库设计、核心模块实现到文档怎么写、答辩怎么演示、哪些坑必须提前避开。适合正在做课程设计的学生也适合想拿一个完整 CRUD 项目练手 Java Web 的初学者。我不会假设你手里已经有一份现成源码而是按最常见的可靠方案把每一步该做什么、参数怎么设讲清楚你照着搭就能得到一个属于自己的版本。2. 技术选型与工程结构为什么这套组合最适合课程设计2.1 三种常见技术栈的取舍课程设计最怕选型过重。你只有两三周时间选错了框架光配环境就能耗掉一半工期。下面是我带过几届学生后总结的对比方案技术组合上手成本答辩加分点适合人群JSP Servlet JDBC原生 Java Web低能讲清底层原理基础薄弱、想稳过Spring Boot MyBatis-Plus主流企业栈中分层清晰、易扩展想拿高分、顺便练面试Spring Boot Vue 前后端分离全栈高演示效果好时间充裕、想冲优秀我的建议是选第二种。原因很实际Spring Boot 把 Tomcat 内嵌了不用单独配服务器MyBatis-Plus 能根据 Java 实体类直接生成建表 SQL 和基础 CRUD省掉大量重复代码而且这套组合正好对应「java面试题」里高频的考点做完课程设计等于顺带复习了一遍。JSP 方案虽然简单但答辩时老师一问「前后端怎么交互的」就容易露怯前后端分离方案演示漂亮但跨域、打包、联调每个环节都可能翻车时间不够别碰。2.2 标准工程目录怎么分一个能让老师一眼看出「这人有工程意识」的目录结构比堆功能更重要。我一般会这样组织electronic-library/ ├── src/main/java/com/library/ │ ├── controller/ // 接收请求参数校验 │ ├── service/ // 业务逻辑 │ │ └── impl/ │ ├── mapper/ // 数据访问接口 │ ├── entity/ // 数据库实体 │ ├── dto/ // 前后端传输对象 │ ├── config/ // 拦截器、跨域等配置 │ └── common/ // 统一返回结果、异常处理 ├── src/main/resources/ │ ├── mapper/ // MyBatis XML复杂查询用 │ ├── static/ // 前端静态页面 │ └── application.yml // 配置文件 └── sql/ └── library.sql // 建表 初始数据分层的好处是答辩时你能指着目录说清楚「请求从 controller 进来经过 service 处理业务再由 mapper 落库」这套话术老师很吃。common包里放一个统一的Result返回类所有接口都返回{code, msg, data}结构前端处理起来也统一。2.3 依赖清单与版本注意pom.xml里核心依赖就几个别贪多dependencies !-- Web 场景启动器内嵌 Tomcat -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis-Plus简化 CRUD -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency !-- MySQL 驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- Lombok省掉 getter/setter -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies这里有个血泪经验MyBatis-Plus 的版本和 Spring Boot 版本要匹配。Spring Boot 3.x 要求 JDK 17 起步如果你电脑上还是 JDK 8就老老实实用 Spring Boot 2.7.x 配 MyBatis-Plus 3.5.x。版本对不上启动时报NoSuchMethodError是家常便饭而且报错信息指向的类往往和真实原因差十万八千里排查起来很折磨。JDK 版本用java -version先确认别想当然。3. 数据库设计与实体映射把表关系一次理清3.1 四张核心表怎么设计电子图书馆的业务本质是「谁借了哪本书、什么时候还」。围绕这个核心最少需要四张表用户表、图书表、借阅记录表、图书分类表。借阅记录表是连接用户和图书的桥梁也是整个项目里唯一需要认真设计的地方。-- 用户表 CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录名, password VARCHAR(100) NOT NULL COMMENT 密码, real_name VARCHAR(50) COMMENT 真实姓名, role TINYINT DEFAULT 0 COMMENT 0普通用户 1管理员, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 图书表 CREATE TABLE book ( id INT PRIMARY KEY AUTO_INCREMENT, isbn VARCHAR(20) UNIQUE COMMENT ISBN号, title VARCHAR(200) NOT NULL COMMENT 书名, author VARCHAR(100) COMMENT 作者, category_id INT COMMENT 分类ID, total INT DEFAULT 1 COMMENT 总库存, available INT DEFAULT 1 COMMENT 可借数量, cover_url VARCHAR(255) COMMENT 封面图 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 借阅记录表 CREATE TABLE borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, book_id INT NOT NULL, borrow_time DATETIME DEFAULT CURRENT_TIMESTAMP, due_time DATETIME COMMENT 应还时间, return_time DATETIME COMMENT 实际归还时间, status TINYINT DEFAULT 0 COMMENT 0借出 1已还 2逾期, INDEX idx_user (user_id), INDEX idx_book (book_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;设计上有两个关键点。第一图书表用total和available两个字段而不是只存一个库存数因为「总藏书量」和「当前可借数」是两个概念借出后available减一归还后加一total不变这样能直观看出有多少本在外借。第二借阅记录表用status字段标记状态而不是靠return_time是否为空来判断因为逾期是第三种状态光靠时间字段判断会写出一堆嵌套 if。3.2 用 MyBatis-Plus 从实体类反向生成表热词里提到的「mybatisplus根据java实体类生成创建表的sql语句」是个很实用的技巧。MyBatis-Plus 本身不直接生成建表 SQL但配合注解可以做到。实体类上标注TableName和TableField字段类型和注释写清楚Data TableName(book) public class Book { TableId(type IdType.AUTO) private Integer id; TableField(title) private String title; TableField(author) private String author; TableField(available) private Integer available; }然后在配置里开启 SQL 日志启动时把mybatis-plus.configuration.log-impl设为org.apache.ibatis.logging.stdout.StdOutImpl你就能在控制台看到 MyBatis-Plus 实际执行的 SQL。想拿到建表语句更可靠的做法是用 Navicat 或 DataGrip 连上数据库后右键「导出 SQL」或者用mysqldump -u root -p library library.sql命令导出。别指望框架自动帮你生成 DDL那是 ORM 框架的边界之外。3.3 分页查询的配置课程设计里图书列表一定要分页否则数据一多页面就崩。MyBatis-Plus 的分页需要注册一个拦截器漏了这一步分页会失效——查出来永远是全部数据这是新手最常踩的坑之一。Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); // 添加分页插件指定数据库类型为 MySQL interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }配置好之后Service 里调用page(new Page(pageNum, pageSize), queryWrapper)就能自动分页。pageNum从 1 开始pageSize建议设 10 或 15太大一页显示不下太小翻页太频繁。返回的Page对象里带total总条数和records当前页数据前端拿这两个字段就能渲染分页条。4. 核心业务实现借书还书这条主线怎么跑通4.1 借书逻辑与库存并发借书看起来简单其实是整个项目里唯一有并发风险的地方。如果两个用户同时借最后一本书不做处理就会出现库存变成 -1 的情况。课程设计里老师未必会问并发但你要是主动提出来并解决绝对是加分项。Service public class BorrowServiceImpl implements BorrowService { Autowired private BookMapper bookMapper; Autowired private BorrowRecordMapper recordMapper; Override Transactional(rollbackFor Exception.class) public Result borrow(Integer userId, Integer bookId) { // 1. 查询图书判断可借数量 Book book bookMapper.selectById(bookId); if (book null) { return Result.fail(图书不存在); } if (book.getAvailable() 0) { return Result.fail(该书已全部借出); } // 2. 扣减库存用乐观锁或条件更新防止超借 int rows bookMapper.decreaseAvailable(bookId); if (rows 0) { return Result.fail(借阅失败请重试); } // 3. 写入借阅记录应还时间为 30 天后 BorrowRecord record new BorrowRecord(); record.setUserId(userId); record.setBookId(bookId); record.setDueTime(LocalDateTime.now().plusDays(30)); record.setStatus(0); recordMapper.insert(record); return Result.success(借阅成功); } }关键在第二步。decreaseAvailable不是普通的 update而是带条件的UPDATE book SET available available - 1 WHERE id #{bookId} AND available 0这条 SQL 在数据库层面保证了「只有还有库存时才扣减」返回影响行数为 0 就说明被别人抢先了。这比在 Java 代码里先查再改要可靠得多因为查和改之间有时间窗口。Transactional注解保证扣库存和写记录要么都成功要么都回滚不会出现扣了库存却没记录的情况。4.2 归还与逾期判断归还逻辑要处理三件事更新记录状态、恢复库存、判断是否逾期。逾期判断不能只在归还时做列表展示时也要动态算否则用户看到的状态永远是「借出中」。Override Transactional(rollbackFor Exception.class) public Result returnBook(Integer recordId) { BorrowRecord record recordMapper.selectById(recordId); if (record null || record.getStatus() 1) { return Result.fail(记录不存在或已归还); } // 判断是否逾期 LocalDateTime now LocalDateTime.now(); int status now.isAfter(record.getDueTime()) ? 2 : 1; record.setReturnTime(now); record.setStatus(status); recordMapper.updateById(record); // 恢复库存 bookMapper.increaseAvailable(record.getBookId()); return Result.success(status 2 ? 归还成功已逾期 : 归还成功); }increaseAvailable就是简单的available available 1但要注意加上限判断别让可借数超过总数。列表查询时对于status 0的记录可以在 SQL 里用CASE WHEN due_time NOW() THEN 2 ELSE 0 END动态显示逾期状态这样不用定时任务也能让用户看到实时状态。4.3 登录拦截与权限控制课程设计里管理员和普通用户看到的菜单不一样这需要拦截器。用 Spring 的HandlerInterceptor实现在preHandle里检查 session 或 token。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(/static)) { return true; } Object user request.getSession().getAttribute(user); if (user null) { response.setStatus(401); response.getWriter().write({\code\:401,\msg\:\请先登录\}); return false; } return true; } }拦截器注册时用addPathPatterns(/**).excludePathPatterns(/login, /css/**, /js/**)把登录接口和静态资源排除掉否则登录页自己都被拦了会陷入死循环。管理员权限的判断放在具体接口里比如删除图书的接口开头检查session里的role是否为 1不是就返回 403。5. 避坑与排查这些错误我替你踩过了5.1 启动报数据库连接失败现象项目启动时抛Communications link failure或Access denied for user。原因通常是application.yml里的数据库地址、端口、用户名密码和实际不一致或者 MySQL 服务根本没启动。解决先用命令行mysql -u root -p确认能连上再核对配置。注意 MySQL 8 的驱动类名是com.mysql.cj.jdbc.DriverURL 要带时区参数serverTimezoneAsia/Shanghai否则会报时区错误。5.2 中文乱码现象页面显示的书名变成问号或方块。原因有两个层面数据库表的字符集不是utf8mb4或者连接 URL 没指定编码。解决建表时统一用DEFAULT CHARSETutf8mb4连接 URL 加上useUnicodetruecharacterEncodingutf8。如果已经建好表才发现用ALTER TABLE book CONVERT TO CHARACTER SET utf8mb4改回来。5.3 分页查出来是全部数据现象调分页接口返回的records里是整张表的数据total也不对。原因几乎肯定是忘了注册PaginationInnerInterceptor拦截器。解决检查MybatisPlusConfig类有没有被Configuration注解拦截器有没有加进去。这个坑太常见了我见过不止一个同学在这卡了一下午。5.4 静态资源 404现象页面能打开但 CSS、JS 加载失败控制台一堆 404。原因Spring Boot 默认从src/main/resources/static/找静态资源如果你把前端文件放在了别的地方或者拦截器把静态资源也拦了就会 404。解决确认文件位置正确拦截器里excludePathPatterns把/static/**、/css/**、/js/**都排除掉。5.5 事务不生效现象借书时库存扣了但记录没写进去或者反过来。原因Transactional注解的方法不是public的或者同类内部方法直接调用没走代理。解决确保注解方法为public且从外部类调用。如果确实需要内部调用注入自己或用AopContext.currentProxy()但课程设计里直接拆成两个 Service 更简单。6. 文档与答辩让源码之外的部分也拿分6.1 课程设计文档该写哪几块很多同学代码写得不错文档却只有几页截图最后总分被拉下来。一份合格的课程设计文档我建议包含这几部分需求分析用一两段说清系统要解决什么问题、系统设计架构图、E-R 图、模块划分、数据库设计每张表的字段说明和关系、核心功能实现挑借书、还书、分页查询三个讲透贴关键代码和运行截图、测试与总结列出测试用例和结果。E-R 图用 draw.io 画别手绘拍照观感差很多。文档里的代码片段不要整段复制挑核心的十几行配上文字说明「这段代码解决了什么问题」。老师看文档看的是你的思路不是代码量。截图要清晰最好带上浏览器地址栏证明是真跑起来的不是从网上扒的。6.2 答辩演示的流程设计答辩时间通常只有五到十分钟演示流程要提前排练。我的建议是先用管理员账号登录展示图书管理增删改查 分页再切到普通用户借一本书展示库存变化然后归还展示记录状态更新。这条主线走完核心功能就全覆盖了。演示前把数据库重置到初始状态别让之前测试的脏数据影响效果。老师常问的问题就那么几个「你的数据库有几张表关系是什么」「借书时如果两个人同时借最后一本怎么办」「密码是怎么存的」。前两个前面都讲了密码存储千万别用明文用 MD5 加盐或者 BCrypt 都行答辩时主动说「密码经过加密存储」是个加分点。6.3 一个提升演示效果的小技巧如果时间允许给图书列表加上封面图。封面图不用真的去下载用一个占位图服务或者本地放几张图根据 ISBN 或书名 hash 取模选一张。这样列表页看起来丰富很多演示时观感直接上一个档次。实现上就是在Book实体加个coverUrl字段前端img标签渲染。成本很低但老师的第一印象会好很多。最后说个我自己的习惯每次做完课程设计我都会把项目重新从零部署一遍记录下每一步命令和遇到的报错。这份记录比任何文档都值钱因为它证明了「这个项目真的能跑起来」。你答辩前也这么做一次心里就有底了。希望帮到你。本文还有配套的精品资源点击获取
简介这份资源是面向高校计算机专业学生与Java初学者的一套课程设计完整实践包围绕电子图书馆的图书借阅管理场景展开帮助读者在真实项目中理解Java Web开发流程。系统区分普通用户与管理员两类角色普通用户可浏览、检索图书并查看借阅记录管理员则能管理用户信息与图书库存技术栈采用Maven构建、Mybatis持久层与MySQL数据库覆盖需求分析、数据库设计到接口实现的多个环节。压缩包共231个文件约5.63MB包含30个java源码、19个jsp页面、48个xml配置、21个js脚本以及css、图片、字体等前端资源另附sql建库脚本与说明文档目录结构清晰便于按模块阅读与二次开发。目前已有54人学习下载适合作为课程设计参考模板也可用于巩固Java编程、数据库设计与软件工程知识。1. 电子图书馆课程设计一份能跑起来的 Java 项目该长什么样很多同学做 Java 课程设计时卡住的地方从来不是「不会写代码」而是不知道一个完整的、能演示、能答辩的项目到底该包含哪些东西。电子图书馆这个题目每年被选中的概率极高原因很直接业务场景清晰图书、用户、借阅、归还数据库表关系典型一对多、多对多都有前后端交互完整还天然适合塞进权限控制和分页查询这些加分项。但真正动手时你会发现网上搜到的「java课程设计案例源码」要么只有一堆散装类文件没有数据库脚本要么跑起来报一堆环境错误要么文档只有几页截图没有部署说明。这篇笔记要解决的就是这件事把「电子图书馆项目源码附带文档」拆成一条可复现的路径——从技术选型、数据库设计、核心模块实现到文档怎么写、答辩怎么演示、哪些坑必须提前避开。适合正在做课程设计的学生也适合想拿一个完整 CRUD 项目练手 Java Web 的初学者。我不会假设你手里已经有一份现成源码而是按最常见的可靠方案把每一步该做什么、参数怎么设讲清楚你照着搭就能得到一个属于自己的版本。2. 技术选型与工程结构为什么这套组合最适合课程设计2.1 三种常见技术栈的取舍课程设计最怕选型过重。你只有两三周时间选错了框架光配环境就能耗掉一半工期。下面是我带过几届学生后总结的对比方案技术组合上手成本答辩加分点适合人群JSP Servlet JDBC原生 Java Web低能讲清底层原理基础薄弱、想稳过Spring Boot MyBatis-Plus主流企业栈中分层清晰、易扩展想拿高分、顺便练面试Spring Boot Vue 前后端分离全栈高演示效果好时间充裕、想冲优秀我的建议是选第二种。原因很实际Spring Boot 把 Tomcat 内嵌了不用单独配服务器MyBatis-Plus 能根据 Java 实体类直接生成建表 SQL 和基础 CRUD省掉大量重复代码而且这套组合正好对应「java面试题」里高频的考点做完课程设计等于顺带复习了一遍。JSP 方案虽然简单但答辩时老师一问「前后端怎么交互的」就容易露怯前后端分离方案演示漂亮但跨域、打包、联调每个环节都可能翻车时间不够别碰。2.2 标准工程目录怎么分一个能让老师一眼看出「这人有工程意识」的目录结构比堆功能更重要。我一般会这样组织electronic-library/ ├── src/main/java/com/library/ │ ├── controller/ // 接收请求参数校验 │ ├── service/ // 业务逻辑 │ │ └── impl/ │ ├── mapper/ // 数据访问接口 │ ├── entity/ // 数据库实体 │ ├── dto/ // 前后端传输对象 │ ├── config/ // 拦截器、跨域等配置 │ └── common/ // 统一返回结果、异常处理 ├── src/main/resources/ │ ├── mapper/ // MyBatis XML复杂查询用 │ ├── static/ // 前端静态页面 │ └── application.yml // 配置文件 └── sql/ └── library.sql // 建表 初始数据分层的好处是答辩时你能指着目录说清楚「请求从 controller 进来经过 service 处理业务再由 mapper 落库」这套话术老师很吃。common包里放一个统一的Result返回类所有接口都返回{code, msg, data}结构前端处理起来也统一。2.3 依赖清单与版本注意pom.xml里核心依赖就几个别贪多dependencies !-- Web 场景启动器内嵌 Tomcat -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis-Plus简化 CRUD -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency !-- MySQL 驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- Lombok省掉 getter/setter -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies这里有个血泪经验MyBatis-Plus 的版本和 Spring Boot 版本要匹配。Spring Boot 3.x 要求 JDK 17 起步如果你电脑上还是 JDK 8就老老实实用 Spring Boot 2.7.x 配 MyBatis-Plus 3.5.x。版本对不上启动时报NoSuchMethodError是家常便饭而且报错信息指向的类往往和真实原因差十万八千里排查起来很折磨。JDK 版本用java -version先确认别想当然。3. 数据库设计与实体映射把表关系一次理清3.1 四张核心表怎么设计电子图书馆的业务本质是「谁借了哪本书、什么时候还」。围绕这个核心最少需要四张表用户表、图书表、借阅记录表、图书分类表。借阅记录表是连接用户和图书的桥梁也是整个项目里唯一需要认真设计的地方。-- 用户表 CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录名, password VARCHAR(100) NOT NULL COMMENT 密码, real_name VARCHAR(50) COMMENT 真实姓名, role TINYINT DEFAULT 0 COMMENT 0普通用户 1管理员, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 图书表 CREATE TABLE book ( id INT PRIMARY KEY AUTO_INCREMENT, isbn VARCHAR(20) UNIQUE COMMENT ISBN号, title VARCHAR(200) NOT NULL COMMENT 书名, author VARCHAR(100) COMMENT 作者, category_id INT COMMENT 分类ID, total INT DEFAULT 1 COMMENT 总库存, available INT DEFAULT 1 COMMENT 可借数量, cover_url VARCHAR(255) COMMENT 封面图 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 借阅记录表 CREATE TABLE borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, book_id INT NOT NULL, borrow_time DATETIME DEFAULT CURRENT_TIMESTAMP, due_time DATETIME COMMENT 应还时间, return_time DATETIME COMMENT 实际归还时间, status TINYINT DEFAULT 0 COMMENT 0借出 1已还 2逾期, INDEX idx_user (user_id), INDEX idx_book (book_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;设计上有两个关键点。第一图书表用total和available两个字段而不是只存一个库存数因为「总藏书量」和「当前可借数」是两个概念借出后available减一归还后加一total不变这样能直观看出有多少本在外借。第二借阅记录表用status字段标记状态而不是靠return_time是否为空来判断因为逾期是第三种状态光靠时间字段判断会写出一堆嵌套 if。3.2 用 MyBatis-Plus 从实体类反向生成表热词里提到的「mybatisplus根据java实体类生成创建表的sql语句」是个很实用的技巧。MyBatis-Plus 本身不直接生成建表 SQL但配合注解可以做到。实体类上标注TableName和TableField字段类型和注释写清楚Data TableName(book) public class Book { TableId(type IdType.AUTO) private Integer id; TableField(title) private String title; TableField(author) private String author; TableField(available) private Integer available; }然后在配置里开启 SQL 日志启动时把mybatis-plus.configuration.log-impl设为org.apache.ibatis.logging.stdout.StdOutImpl你就能在控制台看到 MyBatis-Plus 实际执行的 SQL。想拿到建表语句更可靠的做法是用 Navicat 或 DataGrip 连上数据库后右键「导出 SQL」或者用mysqldump -u root -p library library.sql命令导出。别指望框架自动帮你生成 DDL那是 ORM 框架的边界之外。3.3 分页查询的配置课程设计里图书列表一定要分页否则数据一多页面就崩。MyBatis-Plus 的分页需要注册一个拦截器漏了这一步分页会失效——查出来永远是全部数据这是新手最常踩的坑之一。Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); // 添加分页插件指定数据库类型为 MySQL interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }配置好之后Service 里调用page(new Page(pageNum, pageSize), queryWrapper)就能自动分页。pageNum从 1 开始pageSize建议设 10 或 15太大一页显示不下太小翻页太频繁。返回的Page对象里带total总条数和records当前页数据前端拿这两个字段就能渲染分页条。4. 核心业务实现借书还书这条主线怎么跑通4.1 借书逻辑与库存并发借书看起来简单其实是整个项目里唯一有并发风险的地方。如果两个用户同时借最后一本书不做处理就会出现库存变成 -1 的情况。课程设计里老师未必会问并发但你要是主动提出来并解决绝对是加分项。Service public class BorrowServiceImpl implements BorrowService { Autowired private BookMapper bookMapper; Autowired private BorrowRecordMapper recordMapper; Override Transactional(rollbackFor Exception.class) public Result borrow(Integer userId, Integer bookId) { // 1. 查询图书判断可借数量 Book book bookMapper.selectById(bookId); if (book null) { return Result.fail(图书不存在); } if (book.getAvailable() 0) { return Result.fail(该书已全部借出); } // 2. 扣减库存用乐观锁或条件更新防止超借 int rows bookMapper.decreaseAvailable(bookId); if (rows 0) { return Result.fail(借阅失败请重试); } // 3. 写入借阅记录应还时间为 30 天后 BorrowRecord record new BorrowRecord(); record.setUserId(userId); record.setBookId(bookId); record.setDueTime(LocalDateTime.now().plusDays(30)); record.setStatus(0); recordMapper.insert(record); return Result.success(借阅成功); } }关键在第二步。decreaseAvailable不是普通的 update而是带条件的UPDATE book SET available available - 1 WHERE id #{bookId} AND available 0这条 SQL 在数据库层面保证了「只有还有库存时才扣减」返回影响行数为 0 就说明被别人抢先了。这比在 Java 代码里先查再改要可靠得多因为查和改之间有时间窗口。Transactional注解保证扣库存和写记录要么都成功要么都回滚不会出现扣了库存却没记录的情况。4.2 归还与逾期判断归还逻辑要处理三件事更新记录状态、恢复库存、判断是否逾期。逾期判断不能只在归还时做列表展示时也要动态算否则用户看到的状态永远是「借出中」。Override Transactional(rollbackFor Exception.class) public Result returnBook(Integer recordId) { BorrowRecord record recordMapper.selectById(recordId); if (record null || record.getStatus() 1) { return Result.fail(记录不存在或已归还); } // 判断是否逾期 LocalDateTime now LocalDateTime.now(); int status now.isAfter(record.getDueTime()) ? 2 : 1; record.setReturnTime(now); record.setStatus(status); recordMapper.updateById(record); // 恢复库存 bookMapper.increaseAvailable(record.getBookId()); return Result.success(status 2 ? 归还成功已逾期 : 归还成功); }increaseAvailable就是简单的available available 1但要注意加上限判断别让可借数超过总数。列表查询时对于status 0的记录可以在 SQL 里用CASE WHEN due_time NOW() THEN 2 ELSE 0 END动态显示逾期状态这样不用定时任务也能让用户看到实时状态。4.3 登录拦截与权限控制课程设计里管理员和普通用户看到的菜单不一样这需要拦截器。用 Spring 的HandlerInterceptor实现在preHandle里检查 session 或 token。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(/static)) { return true; } Object user request.getSession().getAttribute(user); if (user null) { response.setStatus(401); response.getWriter().write({\code\:401,\msg\:\请先登录\}); return false; } return true; } }拦截器注册时用addPathPatterns(/**).excludePathPatterns(/login, /css/**, /js/**)把登录接口和静态资源排除掉否则登录页自己都被拦了会陷入死循环。管理员权限的判断放在具体接口里比如删除图书的接口开头检查session里的role是否为 1不是就返回 403。5. 避坑与排查这些错误我替你踩过了5.1 启动报数据库连接失败现象项目启动时抛Communications link failure或Access denied for user。原因通常是application.yml里的数据库地址、端口、用户名密码和实际不一致或者 MySQL 服务根本没启动。解决先用命令行mysql -u root -p确认能连上再核对配置。注意 MySQL 8 的驱动类名是com.mysql.cj.jdbc.DriverURL 要带时区参数serverTimezoneAsia/Shanghai否则会报时区错误。5.2 中文乱码现象页面显示的书名变成问号或方块。原因有两个层面数据库表的字符集不是utf8mb4或者连接 URL 没指定编码。解决建表时统一用DEFAULT CHARSETutf8mb4连接 URL 加上useUnicodetruecharacterEncodingutf8。如果已经建好表才发现用ALTER TABLE book CONVERT TO CHARACTER SET utf8mb4改回来。5.3 分页查出来是全部数据现象调分页接口返回的records里是整张表的数据total也不对。原因几乎肯定是忘了注册PaginationInnerInterceptor拦截器。解决检查MybatisPlusConfig类有没有被Configuration注解拦截器有没有加进去。这个坑太常见了我见过不止一个同学在这卡了一下午。5.4 静态资源 404现象页面能打开但 CSS、JS 加载失败控制台一堆 404。原因Spring Boot 默认从src/main/resources/static/找静态资源如果你把前端文件放在了别的地方或者拦截器把静态资源也拦了就会 404。解决确认文件位置正确拦截器里excludePathPatterns把/static/**、/css/**、/js/**都排除掉。5.5 事务不生效现象借书时库存扣了但记录没写进去或者反过来。原因Transactional注解的方法不是public的或者同类内部方法直接调用没走代理。解决确保注解方法为public且从外部类调用。如果确实需要内部调用注入自己或用AopContext.currentProxy()但课程设计里直接拆成两个 Service 更简单。6. 文档与答辩让源码之外的部分也拿分6.1 课程设计文档该写哪几块很多同学代码写得不错文档却只有几页截图最后总分被拉下来。一份合格的课程设计文档我建议包含这几部分需求分析用一两段说清系统要解决什么问题、系统设计架构图、E-R 图、模块划分、数据库设计每张表的字段说明和关系、核心功能实现挑借书、还书、分页查询三个讲透贴关键代码和运行截图、测试与总结列出测试用例和结果。E-R 图用 draw.io 画别手绘拍照观感差很多。文档里的代码片段不要整段复制挑核心的十几行配上文字说明「这段代码解决了什么问题」。老师看文档看的是你的思路不是代码量。截图要清晰最好带上浏览器地址栏证明是真跑起来的不是从网上扒的。6.2 答辩演示的流程设计答辩时间通常只有五到十分钟演示流程要提前排练。我的建议是先用管理员账号登录展示图书管理增删改查 分页再切到普通用户借一本书展示库存变化然后归还展示记录状态更新。这条主线走完核心功能就全覆盖了。演示前把数据库重置到初始状态别让之前测试的脏数据影响效果。老师常问的问题就那么几个「你的数据库有几张表关系是什么」「借书时如果两个人同时借最后一本怎么办」「密码是怎么存的」。前两个前面都讲了密码存储千万别用明文用 MD5 加盐或者 BCrypt 都行答辩时主动说「密码经过加密存储」是个加分点。6.3 一个提升演示效果的小技巧如果时间允许给图书列表加上封面图。封面图不用真的去下载用一个占位图服务或者本地放几张图根据 ISBN 或书名 hash 取模选一张。这样列表页看起来丰富很多演示时观感直接上一个档次。实现上就是在Book实体加个coverUrl字段前端img标签渲染。成本很低但老师的第一印象会好很多。最后说个我自己的习惯每次做完课程设计我都会把项目重新从零部署一遍记录下每一步命令和遇到的报错。这份记录比任何文档都值钱因为它证明了「这个项目真的能跑起来」。你答辩前也这么做一次心里就有底了。希望帮到你。本文还有配套的精品资源点击获取
