尧图网页设计 
简介本资源是一套面向信息技术专业本科生的Java毕业设计实战项目——基于SpringBoot与MyBatis开发的Web版图书管理系统适用于课程设计、毕设选题及Java全栈入门实践。系统涵盖用户管理、图书增删改查、借阅记录、分类检索等核心功能完整呈现企业级Web应用的分层架构设计与数据库交互逻辑。压缩包共75个文件含23个Java业务与控制器类体现SpringBootMyBatis整合、15个HTML页面前端视图、10个Mapper XML映射文件数据持久层实现、6个CSS与5个JS文件界面交互、1个SQL建库脚本、1个application.yml配置及README.md说明文档结构规范开箱即用。资源大小为15.37MB目录以Graduation Design为根符合Maven标准布局便于IDE导入与二次开发。目前已有100人学习下载可直接用于答辩演示、代码参考或教学案例拓展尤其适合夯实SpringBoot自动配置、RESTful接口设计、MyBatis动态SQL等关键技术点。1. 这不是“又一个图书管理系统”它是一份能过答辩、能跑通、能改出新功能的 Spring Boot MyBatis 实战骨架很多同学拿到“基于 Spring Boot MyBatis 的图书管理系统 Web 课程设计”这个题目时第一反应是去 GitHub 搜 zip 包、解压、改包名、换数据库连接、硬着头皮跑起来——结果卡在登录页 404或插入图书时报Invalid bound statement (not found)又或者前端页面样式全乱、搜索功能点不动。这不是代码写得不好而是没理清这个标题背后的真实交付要求它必须是一个可验证的最小闭环 Web 工程——有用户登录鉴权、图书增删改查、分类/状态筛选、数据持久化到 MySQL且所有层Controller → Service → Mapper → XML/注解调用链路清晰、日志可追踪、错误可定位。它不追求高并发或微服务但必须体现 Spring Boot 自动配置能力、MyBatis SQL 映射逻辑、RESTful 接口设计规范以及课程设计最看重的可演示性与可扩展性。适合大三下学期 Java Web 课程、数据库原理课设、或软件工程综合实训——你不需要从零造轮子但必须亲手把每个模块“拧紧”让老师能输入 URL 就看到首页点“添加图书”就弹表单填完提交后列表立刻刷新。2. 从零搭建可运行骨架Spring Boot 3.x MyBatis 3.5.x 的最小依赖与目录结构2.1 为什么选 Spring Boot 3.x 而非 2.x版本兼容性是课程设计的第一道坎当前主流教学环境IDEA 2023、JDK 17、MySQL 8.0已普遍适配 Spring Boot 3.x。若强行使用 Spring Boot 2.7.x需 JDK 8–17会遇到javax.*包被移除导致 MyBatis 注解解析失败、Thymeleaf 模板引擎报org.thymeleaf.spring6找不到类等问题。而 Spring Boot 3.x 默认启用 Jakarta EE 9 命名空间如jakarta.servlet.*MyBatis 3.5.13 已完全兼容。课程设计中“能跑通”比“用旧版”重要得多——避免因版本错配导致的 ClassNotFoundException 或 NoClassDefFoundError就是节省 3 小时调试时间。提示不要用spring-boot-starter-web简单引入必须显式声明mybatis-spring-boot-starter并指定版本否则 Spring Boot 3.x 的自动配置会跳过 MyBatis 初始化。2.2 Maven 依赖配置精简、可控、无冲突以下为pom.xml中核心依赖块已剔除课程设计无需的 starter如 actuator、security-oauth2properties java.version17/java.version project.build.sourceEncodingUTF-8/project.build.sourceEncoding mybatis.version3.5.13/mybatis.version /properties dependencies !-- Spring Boot Web 核心 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis 集成关键必须指定版本 -- dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version3.0.3/version !-- 对应 MyBatis 3.5.13 Spring Boot 3.1.x -- /dependency !-- MySQL 驱动8.0 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency !-- Thymeleaf 模板引擎课程设计首选无需 Vue/React 构建 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-thymeleaf/artifactId /dependency !-- Lombok减少 getter/setter 冗余代码 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies参数说明mybatis-spring-boot-starter 3.0.3是 Spring Boot 3.1.x 的官方推荐版本它内嵌了 MyBatis 3.5.13避免手动管理 MyBatis 版本冲突mysql-connector-java不再声明version由 Spring Boot 3.x 自动匹配8.0.33防止因驱动版本过低导致Public Key Retrieval is not allowed错误移除spring-boot-starter-validation等非必需依赖降低 jar 包体积和启动耗时符合课程设计轻量级要求。2.3 标准目录结构让老师一眼看懂你的分层逻辑课程设计评分常关注“是否符合 MVC 分层规范”。以下为推荐目录src/main/java/com/example/library下├── LibraryApplication.java // 启动类含 SpringBootApplication ├── controller/ │ ├── BookController.java // 处理 /book/* 请求返回 ModelAndView 或 JSON ├── service/ │ ├── BookService.java // 定义业务接口如 addBook, searchBooks │ └── impl/BookServiceImpl.java // 实现类注入 Mapper ├── mapper/ │ ├── BookMapper.java // 接口含 Select/Insert 等注解 或 XML 绑定 │ └── BookMapper.xml // 若用 XML 方式放 resources/mapper/ 下 ├── entity/ │ └── Book.java // Lombok 注解实体类Data, NoArgsConstructor ├── dto/ │ └── BookQueryDTO.java // 查询条件封装类含 pageNum, pageSize, title 等 └── config/ └── MyBatisConfig.java // 可选自定义 Configuration如开启二级缓存关键约束BookMapper.java必须用Mapper注解若用 XML则MapperScan(com.example.library.mapper)在启动类上BookMapper.xml文件名必须与接口名一致BookMapper.xml对应BookMapper.java且放在resources/mapper/目录下Book.java中字段名如bookName必须与数据库列名book_name保持映射关系——通过TableField(book_name)或全局配置map-underscore-to-camel-casetrue实现。3. MyBatis 数据操作落地XML 与注解双模式实现图书 CRUD避开 90% 的 SQL 映射坑3.1 数据库建表脚本字段命名、索引、字符集必须符合课程设计验收标准MySQL 8.0 建表语句直接执行即可无需修改CREATE DATABASE IF NOT EXISTS library_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE library_db; CREATE TABLE book ( id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT 主键ID, isbn VARCHAR(20) NOT NULL COMMENT ISBN号, title VARCHAR(100) NOT NULL COMMENT 书名, author VARCHAR(50) NOT NULL COMMENT 作者, publisher VARCHAR(50) COMMENT 出版社, publish_date DATE COMMENT 出版日期, category ENUM(文学,科技,教育,儿童,其他) DEFAULT 其他 COMMENT 分类, status TINYINT DEFAULT 1 COMMENT 状态1-在馆0-借出, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 更新时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT图书信息表; -- 添加联合索引提升查询性能课程设计常考“如何优化搜索” CREATE INDEX idx_title_author ON book(title, author);为什么用utf8mb4而非utf8MySQL 的utf8实际只支持 3 字节 UTF-8 字符无法存储 emoji 或生僻汉字而课程设计中学生姓名、书名可能含中文标点或特殊符号utf8mb4是唯一安全选择。若建表后出现乱码检查my.cnf中[client]和[mysqld]段是否均设置default-character-set utf8mb4。3.2 MyBatis XML 模式手写 SQL 的可控性与调试优势resources/mapper/BookMapper.xml内容含动态 SQL支持模糊搜索与状态筛选?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.library.mapper.BookMapper !-- 查询总数用于分页 -- select idcountByCondition resultTypejava.lang.Integer SELECT COUNT(*) FROM book where if testtitle ! null and title ! AND title LIKE CONCAT(%, #{title}, %) /if if testauthor ! null and author ! AND author LIKE CONCAT(%, #{author}, %) /if if teststatus ! null AND status #{status} /if /where /select !-- 分页查询MyBatis 自动处理 offset/limit -- select idlistByPage resultTypecom.example.library.entity.Book SELECT * FROM book where if testtitle ! null and title ! AND title LIKE CONCAT(%, #{title}, %) /if if testauthor ! null and author ! AND author LIKE CONCAT(%, #{author}, %) /if if teststatus ! null AND status #{status} /if /where ORDER BY create_time DESC LIMIT #{offset}, #{limit} /select !-- 插入图书返回主键 -- insert idinsert useGeneratedKeystrue keyPropertyid INSERT INTO book (isbn, title, author, publisher, publish_date, category, status) VALUES (#{isbn}, #{title}, #{author}, #{publisher}, #{publishDate}, #{category}, #{status}) /insert !-- 根据 ID 删除 -- delete iddeleteById DELETE FROM book WHERE id #{id} /delete !-- 根据 ID 更新状态借阅/归还 -- update idupdateStatus UPDATE book SET status #{status}, update_time NOW() WHERE id #{id} /update /mapper参数说明与避坑点where标签自动处理 SQL 中多余的AND避免手拼字符串导致语法错误#{}是预编译占位符防 SQL 注入CONCAT(%, #{title}, %)实现模糊匹配切勿写成${title}会导致注入风险课程答辩会被扣分useGeneratedKeystruekeyPropertyid是获取自增主键的唯一可靠方式比SELECT LAST_INSERT_ID()更稳定LIMIT #{offset}, #{limit}中offset(pageNum - 1) * pageSize由 Service 层计算传入避免在 XML 中写复杂表达式。3.3 MyBatis 注解模式轻量级场景下的替代方案附对比表格若课程设计允许简化可用纯注解替代 XML。BookMapper.java示例Mapper public interface BookMapper { Select(SELECT COUNT(*) FROM book WHERE title LIKE CONCAT(%, #{title}, %)) int countByTitle(Param(title) String title); Select(SELECT * FROM book WHERE title LIKE CONCAT(%, #{title}, %) ORDER BY create_time DESC LIMIT #{offset}, #{limit}) ListBook listByTitle(Param(title) String title, Param(offset) int offset, Param(limit) int limit); Insert(INSERT INTO book (isbn, title, author) VALUES (#{isbn}, #{title}, #{author})) Options(useGeneratedKeys true, keyProperty id) void insert(Book book); Delete(DELETE FROM book WHERE id #{id}) void deleteById(Long id); }对比维度XML 模式注解模式SQL 可读性高独立文件SQL 与 Java 分离低SQL 嵌入 Java长语句难维护动态 SQL 支持完整if,foreach等有限需SelectProvider配合课程设计适用性推荐老师易审查 SQL 逻辑仅限简单 CRUD如仅需按 ID 查询调试便利性日志中可直接看到完整 SQL注解 SQL 在日志中显示为一行不易定位注意若用注解模式SelectProvider方法需返回String且必须用StringBuilder拼接不能用运算符否则编译失败。4. Web 层实现与前端联调Thymeleaf 模板 RESTful 接口解决“页面打不开”“数据不刷新”问题4.1 Controller 层RESTful 风格设计与 Thymeleaf 视图路由分离BookController.java关键代码兼顾前后端分离与传统模板两种需求Controller RequestMapping(/book) public class BookController { Autowired private BookService bookService; // 【Thymeleaf 页面入口】返回图书列表页GET /book/list GetMapping(/list) public String listPage(Model model, RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, RequestParam(required false) String title, RequestParam(required false) String author, RequestParam(required false) Integer status) { BookQueryDTO queryDTO new BookQueryDTO(); queryDTO.setTitle(title); queryDTO.setAuthor(author); queryDTO.setStatus(status); PageResultBook pageResult bookService.listBooks(queryDTO, pageNum, pageSize); model.addAttribute(pageResult, pageResult); model.addAttribute(queryDTO, queryDTO); // 保持搜索条件回显 return book/list; // 对应 templates/book/list.html } // 【RESTful API】返回 JSON 数据供 AJAX 调用POST /book/add PostMapping(/add) ResponseBody public ResultString addBook(RequestBody Book book) { try { bookService.addBook(book); return Result.success(添加成功); } catch (Exception e) { return Result.fail(添加失败 e.getMessage()); } } // 【Thymeleaf 表单提交】处理普通表单POST /book/save PostMapping(/save) public String saveBook(Book book, RedirectAttributes redirectAttributes) { bookService.addBook(book); redirectAttributes.addFlashAttribute(message, 图书添加成功); return redirect:/book/list; } }关键设计逻辑/book/list返回 Thymeleaf 模板适合课程设计演示URL 清晰、页面完整/book/add返回 JSON供前端 AJAX 调用如用fetch提交表单后局部刷新/book/save处理传统 form 表单提交methodpost用RedirectAttributes实现重定向后消息提示避免重复提交。4.2 Thymeleaf 模板用最少代码实现可交互列表页templates/book/list.html核心片段含分页与搜索表单!DOCTYPE html html xmlns:thhttp://www.thymeleaf.org head meta charsetUTF-8 title图书管理系统/title link hrefhttps://cdn.jsdelivr.net/npm/bootstrap5.3.0/dist/css/bootstrap.min.css relstylesheet /head body div classcontainer mt-4 !-- 搜索表单 -- form th:action{/book/list} methodget classmb-4 div classrow g-2 div classcol-md-3 input typetext nametitle th:value${queryDTO.title} classform-control placeholder书名 /div div classcol-md-3 input typetext nameauthor th:value${queryDTO.author} classform-control placeholder作者 /div div classcol-md-2 select namestatus classform-select option value全部状态/option option th:value1 th:selected${queryDTO.status 1}在馆/option option th:value0 th:selected${queryDTO.status 0}借出/option /select /div div classcol-md-2 button typesubmit classbtn btn-primary搜索/button a th:href{/book/list} classbtn btn-outline-secondary ms-2重置/a /div /div /form !-- 图书列表 -- table classtable table-striped thead tr thID/th th书名/th th作者/th thISBN/th th状态/th th操作/th /tr /thead tbody tr th:eachbook : ${pageResult.list} td th:text${book.id}/td td th:text${book.title}/td td th:text${book.author}/td td th:text${book.isbn}/td td span th:if${book.status 1} classbadge bg-success在馆/span span th:if${book.status 0} classbadge bg-warning借出/span /td td a th:href{/book/edit/${book.id}} classbtn btn-sm btn-outline-primary编辑/a button typebutton classbtn btn-sm btn-outline-danger onclickif(confirm(确定删除)) window.location.href/book/delete/[[${book.id}]];删除/button /td /tr /tbody /table !-- 分页组件 -- nav aria-label图书分页 ul classpagination li classpage-item th:classappend${pageResult.pageNum 1} ? disabled a classpage-link th:href{/book/list(pageNum${pageResult.pageNum - 1}, title${queryDTO.title}, author${queryDTO.author}, status${queryDTO.status})} tabindex-1上一页/a /li li classpage-item th:eachi : ${#numbers.sequence(1, pageResult.totalPages)} a classpage-link th:href{/book/list(pageNum${i}, title${queryDTO.title}, author${queryDTO.author}, status${queryDTO.status})} th:text${i} th:classappend${pageResult.pageNum i} ? active/a /li li classpage-item th:classappend${pageResult.pageNum pageResult.totalPages} ? disabled a classpage-link th:href{/book/list(pageNum${pageResult.pageNum 1}, title${queryDTO.title}, author${queryDTO.author}, status${queryDTO.status})}下一页/a /li /ul /nav /div /body /htmlThymeleaf 关键语法说明th:eachbook : ${pageResult.list}遍历分页数据pageResult是 Service 返回的封装对象th:href{/book/list(...)}自动生成带参数的 URL避免手动拼接?pageNum1titlexxxth:classappend动态添加 CSS 类如.active高亮当前页th:selected控制下拉框默认选中[[${book.id}]]是内联表达式用于 JavaScript 中拼接 URLonclick事件里比th:onlick更简洁。4.3 解决“加载 web 视图时出错”Thymeleaf 模板路径与静态资源配置若启动后访问/book/list报Whitelabel Error Page或TemplateInputException90% 是模板路径错误。确认以下三点模板文件位置必须放在src/main/resources/templates/book/list.html而非static/目录static仅放 JS/CSS/图片Thymeleaf 配置application.yml中确保未禁用 Thymeleafspring: thymeleaf: enabled: true cache: false # 开发时关闭缓存修改 HTML 立即生效 prefix: classpath:/templates/ suffix: .html encoding: UTF-8静态资源路径CSS/JS 放src/main/resources/static/css/app.cssHTML 中引用link th:href{/css/app.css}不能写href/css/app.cssThymeleaf 会忽略。提示若页面样式全无检查浏览器开发者工具 Network 标签页看/css/app.css是否返回 404——这说明静态资源路径配置错误而非 Thymeleaf 问题。5. 课程设计进阶技巧用 MyBatis 二级缓存减少数据库查询用 Logback 输出可追溯的操作日志5.1 开启 MyBatis 二级缓存让“反复搜索同一本书”不再查库MyBatis 二级缓存作用于SqlSessionFactory级别多个 Mapper 共享。对图书管理系统这类读多写少场景开启后可显著降低数据库压力。只需两步第一步在BookMapper.java接口上添加CacheNamespaceMapper CacheNamespace( eviction FIFOCache.class, // 缓存淘汰策略先进先出 flushInterval 60000, // 60秒自动清空一次毫秒 size 100, // 最多缓存 100 条记录 readOnly true // 只读缓存避免并发修改问题 ) public interface BookMapper { // ... 原有方法 }第二步在application.yml中启用全局缓存mybatis: configuration: cache-enabled: true # 开启二级缓存默认 false log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 控制台打印 SQL验证缓存是否生效验证缓存是否工作启动应用首次访问/book/list?titleJava控制台输出 Preparing: SELECT COUNT(*) FROM book WHERE title LIKE ?再次访问相同 URL若控制台不再出现Preparing日志且响应时间明显缩短10ms说明命中二级缓存修改某条图书记录后MyBatis 会自动清空该 Mapper 下所有缓存Update/Delete方法触发无需手动干预。5.2 Logback 日志配置让老师看到“谁在什么时间做了什么操作”课程设计答辩常被问“用户登录后系统怎么知道他能借哪本书”——答案藏在日志里。logback-spring.xml配置src/main/resources/下?xml version1.0 encodingUTF-8? configuration property nameLOG_PATH valuelogs/ appender nameFILE classch.qos.logback.core.rolling.RollingFileAppender file${LOG_PATH}/library.log/file rollingPolicy classch.qos.logback.core.rolling.TimeBasedRollingPolicy fileNamePattern${LOG_PATH}/library.%d{yyyy-MM-dd}.%i.log/fileNamePattern timeBasedFileNamingAndTriggeringPolicy classch.qos.logback.core.rolling.SizeAndTimeBasedFNATP maxFileSize10MB/maxFileSize /timeBasedFileNamingAndTriggeringPolicy /rollingPolicy encoder pattern%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n/pattern /encoder /appender !-- 专门记录图书操作日志 -- logger namecom.example.library.service.BookService levelINFO additivityfalse appender-ref refFILE/ /logger root levelINFO appender-ref refFILE/ /root /configurationService 层日志埋点示例Service public class BookServiceImpl implements BookService { private static final Logger logger LoggerFactory.getLogger(BookServiceImpl.class); Override public void addBook(Book book) { logger.info(用户 {} 正在添加图书ISBN{}, 书名{}, SecurityContextHolder.getContext().getAuthentication().getName(), book.getIsbn(), book.getTitle()); bookMapper.insert(book); logger.info(图书添加成功ID{}, book.getId()); } Override public PageResultBook listBooks(BookQueryDTO queryDTO, Integer pageNum, Integer pageSize) { logger.debug(执行图书搜索条件title{}, author{}, status{}, queryDTO.getTitle(), queryDTO.getAuthor(), queryDTO.getStatus()); // ... 业务逻辑 } }日志价值library.log文件中可清晰看到每次图书操作的用户、时间、参数、结果答辩时老师说“演示一下借书流程”你可直接打开日志文件指出2024-06-15 14:22:33.123 [http-nio-8080-exec-2] INFO ... - 用户 admin 正在添加图书ISBN9787302543210, 书名Spring Boot 实战DEBUG级别记录查询条件INFO级别记录关键动作避免日志爆炸。5.3 一个能立刻用上的技巧用SelectKey替代useGeneratedKeys处理 Oracle/SQL Server 兼容场景虽然课程设计多用 MySQL但若老师要求“适配多种数据库”useGeneratedKeys在 Oracle 中不生效需序列。此时SelectKey是通用解法Insert(INSERT INTO book (isbn, title, author) VALUES (#{isbn}, #{title}, #{author})) SelectKey(statement SELECT SEQ_BOOK.NEXTVAL FROM DUAL, keyProperty id, before true, resultType Long.class) void insertForOracle(Book book);参数说明statement数据库特定的主键生成 SQLOracle 用序列SQL Server 用SELECT SCOPE_IDENTITY()before true在 INSERT 之前执行SELECTKey获取 ID赋值给book.idresultType明确返回类型避免类型转换异常。此技巧让你的 Mapper 接口具备数据库无关性课程设计加分项。本文还有配套的精品资源点击获取 Spring Boot 3 + MyBatis 图书管理系统实战骨架
简介本资源是一套面向信息技术专业本科生的Java毕业设计实战项目——基于SpringBoot与MyBatis开发的Web版图书管理系统适用于课程设计、毕设选题及Java全栈入门实践。系统涵盖用户管理、图书增删改查、借阅记录、分类检索等核心功能完整呈现企业级Web应用的分层架构设计与数据库交互逻辑。压缩包共75个文件含23个Java业务与控制器类体现SpringBootMyBatis整合、15个HTML页面前端视图、10个Mapper XML映射文件数据持久层实现、6个CSS与5个JS文件界面交互、1个SQL建库脚本、1个application.yml配置及README.md说明文档结构规范开箱即用。资源大小为15.37MB目录以Graduation Design为根符合Maven标准布局便于IDE导入与二次开发。目前已有100人学习下载可直接用于答辩演示、代码参考或教学案例拓展尤其适合夯实SpringBoot自动配置、RESTful接口设计、MyBatis动态SQL等关键技术点。1. 这不是“又一个图书管理系统”它是一份能过答辩、能跑通、能改出新功能的 Spring Boot MyBatis 实战骨架很多同学拿到“基于 Spring Boot MyBatis 的图书管理系统 Web 课程设计”这个题目时第一反应是去 GitHub 搜 zip 包、解压、改包名、换数据库连接、硬着头皮跑起来——结果卡在登录页 404或插入图书时报Invalid bound statement (not found)又或者前端页面样式全乱、搜索功能点不动。这不是代码写得不好而是没理清这个标题背后的真实交付要求它必须是一个可验证的最小闭环 Web 工程——有用户登录鉴权、图书增删改查、分类/状态筛选、数据持久化到 MySQL且所有层Controller → Service → Mapper → XML/注解调用链路清晰、日志可追踪、错误可定位。它不追求高并发或微服务但必须体现 Spring Boot 自动配置能力、MyBatis SQL 映射逻辑、RESTful 接口设计规范以及课程设计最看重的可演示性与可扩展性。适合大三下学期 Java Web 课程、数据库原理课设、或软件工程综合实训——你不需要从零造轮子但必须亲手把每个模块“拧紧”让老师能输入 URL 就看到首页点“添加图书”就弹表单填完提交后列表立刻刷新。2. 从零搭建可运行骨架Spring Boot 3.x MyBatis 3.5.x 的最小依赖与目录结构2.1 为什么选 Spring Boot 3.x 而非 2.x版本兼容性是课程设计的第一道坎当前主流教学环境IDEA 2023、JDK 17、MySQL 8.0已普遍适配 Spring Boot 3.x。若强行使用 Spring Boot 2.7.x需 JDK 8–17会遇到javax.*包被移除导致 MyBatis 注解解析失败、Thymeleaf 模板引擎报org.thymeleaf.spring6找不到类等问题。而 Spring Boot 3.x 默认启用 Jakarta EE 9 命名空间如jakarta.servlet.*MyBatis 3.5.13 已完全兼容。课程设计中“能跑通”比“用旧版”重要得多——避免因版本错配导致的 ClassNotFoundException 或 NoClassDefFoundError就是节省 3 小时调试时间。提示不要用spring-boot-starter-web简单引入必须显式声明mybatis-spring-boot-starter并指定版本否则 Spring Boot 3.x 的自动配置会跳过 MyBatis 初始化。2.2 Maven 依赖配置精简、可控、无冲突以下为pom.xml中核心依赖块已剔除课程设计无需的 starter如 actuator、security-oauth2properties java.version17/java.version project.build.sourceEncodingUTF-8/project.build.sourceEncoding mybatis.version3.5.13/mybatis.version /properties dependencies !-- Spring Boot Web 核心 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis 集成关键必须指定版本 -- dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version3.0.3/version !-- 对应 MyBatis 3.5.13 Spring Boot 3.1.x -- /dependency !-- MySQL 驱动8.0 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency !-- Thymeleaf 模板引擎课程设计首选无需 Vue/React 构建 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-thymeleaf/artifactId /dependency !-- Lombok减少 getter/setter 冗余代码 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies参数说明mybatis-spring-boot-starter 3.0.3是 Spring Boot 3.1.x 的官方推荐版本它内嵌了 MyBatis 3.5.13避免手动管理 MyBatis 版本冲突mysql-connector-java不再声明version由 Spring Boot 3.x 自动匹配8.0.33防止因驱动版本过低导致Public Key Retrieval is not allowed错误移除spring-boot-starter-validation等非必需依赖降低 jar 包体积和启动耗时符合课程设计轻量级要求。2.3 标准目录结构让老师一眼看懂你的分层逻辑课程设计评分常关注“是否符合 MVC 分层规范”。以下为推荐目录src/main/java/com/example/library下├── LibraryApplication.java // 启动类含 SpringBootApplication ├── controller/ │ ├── BookController.java // 处理 /book/* 请求返回 ModelAndView 或 JSON ├── service/ │ ├── BookService.java // 定义业务接口如 addBook, searchBooks │ └── impl/BookServiceImpl.java // 实现类注入 Mapper ├── mapper/ │ ├── BookMapper.java // 接口含 Select/Insert 等注解 或 XML 绑定 │ └── BookMapper.xml // 若用 XML 方式放 resources/mapper/ 下 ├── entity/ │ └── Book.java // Lombok 注解实体类Data, NoArgsConstructor ├── dto/ │ └── BookQueryDTO.java // 查询条件封装类含 pageNum, pageSize, title 等 └── config/ └── MyBatisConfig.java // 可选自定义 Configuration如开启二级缓存关键约束BookMapper.java必须用Mapper注解若用 XML则MapperScan(com.example.library.mapper)在启动类上BookMapper.xml文件名必须与接口名一致BookMapper.xml对应BookMapper.java且放在resources/mapper/目录下Book.java中字段名如bookName必须与数据库列名book_name保持映射关系——通过TableField(book_name)或全局配置map-underscore-to-camel-casetrue实现。3. MyBatis 数据操作落地XML 与注解双模式实现图书 CRUD避开 90% 的 SQL 映射坑3.1 数据库建表脚本字段命名、索引、字符集必须符合课程设计验收标准MySQL 8.0 建表语句直接执行即可无需修改CREATE DATABASE IF NOT EXISTS library_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE library_db; CREATE TABLE book ( id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT 主键ID, isbn VARCHAR(20) NOT NULL COMMENT ISBN号, title VARCHAR(100) NOT NULL COMMENT 书名, author VARCHAR(50) NOT NULL COMMENT 作者, publisher VARCHAR(50) COMMENT 出版社, publish_date DATE COMMENT 出版日期, category ENUM(文学,科技,教育,儿童,其他) DEFAULT 其他 COMMENT 分类, status TINYINT DEFAULT 1 COMMENT 状态1-在馆0-借出, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 更新时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT图书信息表; -- 添加联合索引提升查询性能课程设计常考“如何优化搜索” CREATE INDEX idx_title_author ON book(title, author);为什么用utf8mb4而非utf8MySQL 的utf8实际只支持 3 字节 UTF-8 字符无法存储 emoji 或生僻汉字而课程设计中学生姓名、书名可能含中文标点或特殊符号utf8mb4是唯一安全选择。若建表后出现乱码检查my.cnf中[client]和[mysqld]段是否均设置default-character-set utf8mb4。3.2 MyBatis XML 模式手写 SQL 的可控性与调试优势resources/mapper/BookMapper.xml内容含动态 SQL支持模糊搜索与状态筛选?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.library.mapper.BookMapper !-- 查询总数用于分页 -- select idcountByCondition resultTypejava.lang.Integer SELECT COUNT(*) FROM book where if testtitle ! null and title ! AND title LIKE CONCAT(%, #{title}, %) /if if testauthor ! null and author ! AND author LIKE CONCAT(%, #{author}, %) /if if teststatus ! null AND status #{status} /if /where /select !-- 分页查询MyBatis 自动处理 offset/limit -- select idlistByPage resultTypecom.example.library.entity.Book SELECT * FROM book where if testtitle ! null and title ! AND title LIKE CONCAT(%, #{title}, %) /if if testauthor ! null and author ! AND author LIKE CONCAT(%, #{author}, %) /if if teststatus ! null AND status #{status} /if /where ORDER BY create_time DESC LIMIT #{offset}, #{limit} /select !-- 插入图书返回主键 -- insert idinsert useGeneratedKeystrue keyPropertyid INSERT INTO book (isbn, title, author, publisher, publish_date, category, status) VALUES (#{isbn}, #{title}, #{author}, #{publisher}, #{publishDate}, #{category}, #{status}) /insert !-- 根据 ID 删除 -- delete iddeleteById DELETE FROM book WHERE id #{id} /delete !-- 根据 ID 更新状态借阅/归还 -- update idupdateStatus UPDATE book SET status #{status}, update_time NOW() WHERE id #{id} /update /mapper参数说明与避坑点where标签自动处理 SQL 中多余的AND避免手拼字符串导致语法错误#{}是预编译占位符防 SQL 注入CONCAT(%, #{title}, %)实现模糊匹配切勿写成${title}会导致注入风险课程答辩会被扣分useGeneratedKeystruekeyPropertyid是获取自增主键的唯一可靠方式比SELECT LAST_INSERT_ID()更稳定LIMIT #{offset}, #{limit}中offset(pageNum - 1) * pageSize由 Service 层计算传入避免在 XML 中写复杂表达式。3.3 MyBatis 注解模式轻量级场景下的替代方案附对比表格若课程设计允许简化可用纯注解替代 XML。BookMapper.java示例Mapper public interface BookMapper { Select(SELECT COUNT(*) FROM book WHERE title LIKE CONCAT(%, #{title}, %)) int countByTitle(Param(title) String title); Select(SELECT * FROM book WHERE title LIKE CONCAT(%, #{title}, %) ORDER BY create_time DESC LIMIT #{offset}, #{limit}) ListBook listByTitle(Param(title) String title, Param(offset) int offset, Param(limit) int limit); Insert(INSERT INTO book (isbn, title, author) VALUES (#{isbn}, #{title}, #{author})) Options(useGeneratedKeys true, keyProperty id) void insert(Book book); Delete(DELETE FROM book WHERE id #{id}) void deleteById(Long id); }对比维度XML 模式注解模式SQL 可读性高独立文件SQL 与 Java 分离低SQL 嵌入 Java长语句难维护动态 SQL 支持完整if,foreach等有限需SelectProvider配合课程设计适用性推荐老师易审查 SQL 逻辑仅限简单 CRUD如仅需按 ID 查询调试便利性日志中可直接看到完整 SQL注解 SQL 在日志中显示为一行不易定位注意若用注解模式SelectProvider方法需返回String且必须用StringBuilder拼接不能用运算符否则编译失败。4. Web 层实现与前端联调Thymeleaf 模板 RESTful 接口解决“页面打不开”“数据不刷新”问题4.1 Controller 层RESTful 风格设计与 Thymeleaf 视图路由分离BookController.java关键代码兼顾前后端分离与传统模板两种需求Controller RequestMapping(/book) public class BookController { Autowired private BookService bookService; // 【Thymeleaf 页面入口】返回图书列表页GET /book/list GetMapping(/list) public String listPage(Model model, RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, RequestParam(required false) String title, RequestParam(required false) String author, RequestParam(required false) Integer status) { BookQueryDTO queryDTO new BookQueryDTO(); queryDTO.setTitle(title); queryDTO.setAuthor(author); queryDTO.setStatus(status); PageResultBook pageResult bookService.listBooks(queryDTO, pageNum, pageSize); model.addAttribute(pageResult, pageResult); model.addAttribute(queryDTO, queryDTO); // 保持搜索条件回显 return book/list; // 对应 templates/book/list.html } // 【RESTful API】返回 JSON 数据供 AJAX 调用POST /book/add PostMapping(/add) ResponseBody public ResultString addBook(RequestBody Book book) { try { bookService.addBook(book); return Result.success(添加成功); } catch (Exception e) { return Result.fail(添加失败 e.getMessage()); } } // 【Thymeleaf 表单提交】处理普通表单POST /book/save PostMapping(/save) public String saveBook(Book book, RedirectAttributes redirectAttributes) { bookService.addBook(book); redirectAttributes.addFlashAttribute(message, 图书添加成功); return redirect:/book/list; } }关键设计逻辑/book/list返回 Thymeleaf 模板适合课程设计演示URL 清晰、页面完整/book/add返回 JSON供前端 AJAX 调用如用fetch提交表单后局部刷新/book/save处理传统 form 表单提交methodpost用RedirectAttributes实现重定向后消息提示避免重复提交。4.2 Thymeleaf 模板用最少代码实现可交互列表页templates/book/list.html核心片段含分页与搜索表单!DOCTYPE html html xmlns:thhttp://www.thymeleaf.org head meta charsetUTF-8 title图书管理系统/title link hrefhttps://cdn.jsdelivr.net/npm/bootstrap5.3.0/dist/css/bootstrap.min.css relstylesheet /head body div classcontainer mt-4 !-- 搜索表单 -- form th:action{/book/list} methodget classmb-4 div classrow g-2 div classcol-md-3 input typetext nametitle th:value${queryDTO.title} classform-control placeholder书名 /div div classcol-md-3 input typetext nameauthor th:value${queryDTO.author} classform-control placeholder作者 /div div classcol-md-2 select namestatus classform-select option value全部状态/option option th:value1 th:selected${queryDTO.status 1}在馆/option option th:value0 th:selected${queryDTO.status 0}借出/option /select /div div classcol-md-2 button typesubmit classbtn btn-primary搜索/button a th:href{/book/list} classbtn btn-outline-secondary ms-2重置/a /div /div /form !-- 图书列表 -- table classtable table-striped thead tr thID/th th书名/th th作者/th thISBN/th th状态/th th操作/th /tr /thead tbody tr th:eachbook : ${pageResult.list} td th:text${book.id}/td td th:text${book.title}/td td th:text${book.author}/td td th:text${book.isbn}/td td span th:if${book.status 1} classbadge bg-success在馆/span span th:if${book.status 0} classbadge bg-warning借出/span /td td a th:href{/book/edit/${book.id}} classbtn btn-sm btn-outline-primary编辑/a button typebutton classbtn btn-sm btn-outline-danger onclickif(confirm(确定删除)) window.location.href/book/delete/[[${book.id}]];删除/button /td /tr /tbody /table !-- 分页组件 -- nav aria-label图书分页 ul classpagination li classpage-item th:classappend${pageResult.pageNum 1} ? disabled a classpage-link th:href{/book/list(pageNum${pageResult.pageNum - 1}, title${queryDTO.title}, author${queryDTO.author}, status${queryDTO.status})} tabindex-1上一页/a /li li classpage-item th:eachi : ${#numbers.sequence(1, pageResult.totalPages)} a classpage-link th:href{/book/list(pageNum${i}, title${queryDTO.title}, author${queryDTO.author}, status${queryDTO.status})} th:text${i} th:classappend${pageResult.pageNum i} ? active/a /li li classpage-item th:classappend${pageResult.pageNum pageResult.totalPages} ? disabled a classpage-link th:href{/book/list(pageNum${pageResult.pageNum 1}, title${queryDTO.title}, author${queryDTO.author}, status${queryDTO.status})}下一页/a /li /ul /nav /div /body /htmlThymeleaf 关键语法说明th:eachbook : ${pageResult.list}遍历分页数据pageResult是 Service 返回的封装对象th:href{/book/list(...)}自动生成带参数的 URL避免手动拼接?pageNum1titlexxxth:classappend动态添加 CSS 类如.active高亮当前页th:selected控制下拉框默认选中[[${book.id}]]是内联表达式用于 JavaScript 中拼接 URLonclick事件里比th:onlick更简洁。4.3 解决“加载 web 视图时出错”Thymeleaf 模板路径与静态资源配置若启动后访问/book/list报Whitelabel Error Page或TemplateInputException90% 是模板路径错误。确认以下三点模板文件位置必须放在src/main/resources/templates/book/list.html而非static/目录static仅放 JS/CSS/图片Thymeleaf 配置application.yml中确保未禁用 Thymeleafspring: thymeleaf: enabled: true cache: false # 开发时关闭缓存修改 HTML 立即生效 prefix: classpath:/templates/ suffix: .html encoding: UTF-8静态资源路径CSS/JS 放src/main/resources/static/css/app.cssHTML 中引用link th:href{/css/app.css}不能写href/css/app.cssThymeleaf 会忽略。提示若页面样式全无检查浏览器开发者工具 Network 标签页看/css/app.css是否返回 404——这说明静态资源路径配置错误而非 Thymeleaf 问题。5. 课程设计进阶技巧用 MyBatis 二级缓存减少数据库查询用 Logback 输出可追溯的操作日志5.1 开启 MyBatis 二级缓存让“反复搜索同一本书”不再查库MyBatis 二级缓存作用于SqlSessionFactory级别多个 Mapper 共享。对图书管理系统这类读多写少场景开启后可显著降低数据库压力。只需两步第一步在BookMapper.java接口上添加CacheNamespaceMapper CacheNamespace( eviction FIFOCache.class, // 缓存淘汰策略先进先出 flushInterval 60000, // 60秒自动清空一次毫秒 size 100, // 最多缓存 100 条记录 readOnly true // 只读缓存避免并发修改问题 ) public interface BookMapper { // ... 原有方法 }第二步在application.yml中启用全局缓存mybatis: configuration: cache-enabled: true # 开启二级缓存默认 false log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 控制台打印 SQL验证缓存是否生效验证缓存是否工作启动应用首次访问/book/list?titleJava控制台输出 Preparing: SELECT COUNT(*) FROM book WHERE title LIKE ?再次访问相同 URL若控制台不再出现Preparing日志且响应时间明显缩短10ms说明命中二级缓存修改某条图书记录后MyBatis 会自动清空该 Mapper 下所有缓存Update/Delete方法触发无需手动干预。5.2 Logback 日志配置让老师看到“谁在什么时间做了什么操作”课程设计答辩常被问“用户登录后系统怎么知道他能借哪本书”——答案藏在日志里。logback-spring.xml配置src/main/resources/下?xml version1.0 encodingUTF-8? configuration property nameLOG_PATH valuelogs/ appender nameFILE classch.qos.logback.core.rolling.RollingFileAppender file${LOG_PATH}/library.log/file rollingPolicy classch.qos.logback.core.rolling.TimeBasedRollingPolicy fileNamePattern${LOG_PATH}/library.%d{yyyy-MM-dd}.%i.log/fileNamePattern timeBasedFileNamingAndTriggeringPolicy classch.qos.logback.core.rolling.SizeAndTimeBasedFNATP maxFileSize10MB/maxFileSize /timeBasedFileNamingAndTriggeringPolicy /rollingPolicy encoder pattern%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n/pattern /encoder /appender !-- 专门记录图书操作日志 -- logger namecom.example.library.service.BookService levelINFO additivityfalse appender-ref refFILE/ /logger root levelINFO appender-ref refFILE/ /root /configurationService 层日志埋点示例Service public class BookServiceImpl implements BookService { private static final Logger logger LoggerFactory.getLogger(BookServiceImpl.class); Override public void addBook(Book book) { logger.info(用户 {} 正在添加图书ISBN{}, 书名{}, SecurityContextHolder.getContext().getAuthentication().getName(), book.getIsbn(), book.getTitle()); bookMapper.insert(book); logger.info(图书添加成功ID{}, book.getId()); } Override public PageResultBook listBooks(BookQueryDTO queryDTO, Integer pageNum, Integer pageSize) { logger.debug(执行图书搜索条件title{}, author{}, status{}, queryDTO.getTitle(), queryDTO.getAuthor(), queryDTO.getStatus()); // ... 业务逻辑 } }日志价值library.log文件中可清晰看到每次图书操作的用户、时间、参数、结果答辩时老师说“演示一下借书流程”你可直接打开日志文件指出2024-06-15 14:22:33.123 [http-nio-8080-exec-2] INFO ... - 用户 admin 正在添加图书ISBN9787302543210, 书名Spring Boot 实战DEBUG级别记录查询条件INFO级别记录关键动作避免日志爆炸。5.3 一个能立刻用上的技巧用SelectKey替代useGeneratedKeys处理 Oracle/SQL Server 兼容场景虽然课程设计多用 MySQL但若老师要求“适配多种数据库”useGeneratedKeys在 Oracle 中不生效需序列。此时SelectKey是通用解法Insert(INSERT INTO book (isbn, title, author) VALUES (#{isbn}, #{title}, #{author})) SelectKey(statement SELECT SEQ_BOOK.NEXTVAL FROM DUAL, keyProperty id, before true, resultType Long.class) void insertForOracle(Book book);参数说明statement数据库特定的主键生成 SQLOracle 用序列SQL Server 用SELECT SCOPE_IDENTITY()before true在 INSERT 之前执行SELECTKey获取 ID赋值给book.idresultType明确返回类型避免类型转换异常。此技巧让你的 Mapper 接口具备数据库无关性课程设计加分项。本文还有配套的精品资源点击获取