SpringBoot+Mybatis+Thymeleaf+MySQL购书商城系统实战:从选型到库存扣减避坑
发布时间:2026/11/21 9:54:38来源:尧图网络
简介这是一套面向Java Web初学者与课程设计开发者的购书商城系统完整源码基于SpringBoot、Mybatis、Thymeleaf与MySQL构建适合作为毕业设计、实训项目或二次开发的学习起点。系统覆盖用户注册登录、图书浏览、购物车、下单购买、订单管理及后台商品与用户管理等完整购物流程并预留了搜索、分类筛选与图书推荐等扩展空间。压缩包共109个文件约4.81MB以35个Java源码文件为核心配合10个HTML页面、9个JavaScript脚本、8个CSS样式及17张PNG、14张JPG图片资源另有XML、YML、SQL与Maven Wrapper等配置与建库脚本结构清晰便于按模块阅读。目前已有51人学习下载。读者可借此掌握SpringBoot整合Mybatis与Thymeleaf的典型分层写法理解商城业务表设计与订单流转逻辑并在此基础上引入权限控制、搜索引擎或第三方支付进行功能扩展。1. 购书商城系统从 SpringBoot 到 MySQL 的完整落地路径很多 Java 学习者做过的第一个像样的项目就是购书商城。它比博客系统多一层库存与订单的强关联又比通用电商少一堆营销模块刚好卡在能跑通全链路和不至于失控之间。这套基于 SpringBoot Mybatis Thymeleaf MySQL 的购书商城系统核心要解决的是图书浏览、购物车、下单、库存扣减、后台管理这几件事。它适合两类人一是想拿一个完整 CRUD 加事务场景练手的后端新手二是需要一份能讲清楚分层架构的毕设参考。我见过太多人卡在能启动但下单就报错这一步问题往往不在框架而在事务边界和库存并发没想清楚。这篇就按我实际搭过一遍的顺序把选型、建表、关键代码和踩过的坑讲透。2. 技术选型与工程骨架为什么是这四个凑一起2.1 四件套各自的职责边界SpringBoot 负责把 Tomcat、数据源、事务管理器这些基础设施自动装配好让你少写一堆 XML。Mybatis 负责 SQL 与 Java 对象的映射相比 JPA 它更贴近手写 SQL做多表关联查询和复杂统计时可控性更强。Thymeleaf 是服务端模板引擎页面在服务器渲染好再返回对 SEO 友好也不需要前后端分离那套跨域和鉴权联调成本。MySQL 存业务数据图书、用户、订单、库存都落在这里。选这套组合的理由很直接学习曲线平缓资料多出错时排查路径清晰。如果你用 Vue 加后端分离光一个登录态传递就能劝退新手。而 Thymeleaf 把页面和数据绑在一起调试时打开浏览器看渲染结果就行不用开两个终端。需要提醒的是SpringBoot 版本别追太高。2.7.x 是这套组合最稳的区间3.x 之后 Jakarta EE 包名从javax换成jakarta很多老教程的代码直接编译不过。我一般会在pom.xml里锁死版本避免构建时被动升级。2.2 工程目录与依赖配置一个能跑的分层结构大致是这样controller接请求service写业务和事务mapper对应 Mybatis 接口entity是数据库映射对象vo是给页面用的视图对象。别把 entity 直接丢给 Thymeleaf字段一多容易暴露不该暴露的东西。!-- pom.xml 关键依赖版本按需微调 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent dependencies !-- Web Thymeleaf 模板 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-thymeleaf/artifactId /dependency !-- Mybatis 整合 SpringBoot -- dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.1/version /dependency !-- MySQL 驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency /dependencies这段配置里mybatis-spring-boot-starter会自动扫描Mapper注解的接口并注册成 Bean省去手动配置SqlSessionFactory。MySQL 驱动用mysql-connector-j是 8.x 的新坐标老项目里的mysql-connector-java也能用但新起项目建议用新的。application.yml里几个必调参数spring: datasource: url: jdbc:mysql://localhost:3306/bookstore?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false # 开发期关缓存改页面不用重启 prefix: classpath:/templates/ suffix: .html mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.bookstore.entity configuration: map-underscore-to-camel-case: true # book_name 自动映射 bookNameserverTimezone不写会报时区错误这是新手最常见的启动失败原因之一。map-underscore-to-camel-case打开后数据库的book_name能自动对应 Java 的bookName省掉大量resultMap配置。thymeleaf.cache开发期设 false配合 IDEA 的热更新改完 HTML 刷新浏览器就能看到效果不用反复重启。3. 数据库设计图书、库存、订单三张核心表怎么建3.1 表结构与字段类型选择购书商城的表不用多但每张都要经得起推敲。核心是book图书、stock库存、order订单、order_item订单明细、user用户。库存单独拆表是因为下单要扣减、取消要回滚独立出来加行锁更清晰。CREATE TABLE book ( id BIGINT PRIMARY KEY AUTO_INCREMENT, book_name VARCHAR(128) NOT NULL, author VARCHAR(64) NOT NULL, price DECIMAL(10,2) NOT NULL DEFAULT 0.00, cover_url VARCHAR(255) DEFAULT NULL, category_id INT NOT NULL, status TINYINT NOT NULL DEFAULT 1 COMMENT 1上架 0下架, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE stock ( book_id BIGINT PRIMARY KEY, quantity INT NOT NULL DEFAULT 0, version INT NOT NULL DEFAULT 0 COMMENT 乐观锁版本号, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE order ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL UNIQUE, user_id BIGINT NOT NULL, total_amount DECIMAL(10,2) NOT NULL, status TINYINT NOT NULL DEFAULT 0 COMMENT 0待支付 1已支付 2已取消, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_user (user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;价格用DECIMAL(10,2)而不是FLOAT浮点数算钱会出现0.10.20.30000000000000004这种玄学问题对账时能让你怀疑人生。库存表加了version字段做乐观锁后面并发扣减会用到。order是 MySQL 关键字建表时用反引号包起来否则直接语法报错。3.2 库存扣减的两种写法与选择库存扣减是这套系统最容易翻车的地方。常见做法有两种悲观锁SELECT ... FOR UPDATE和乐观锁UPDATE ... WHERE version ?。悲观锁写法简单事务里先锁住库存行再扣SELECT quantity FROM stock WHERE book_id #{bookId} FOR UPDATE; UPDATE stock SET quantity quantity - #{num} WHERE book_id #{bookId};它的问题是锁持有时间长高并发下大量请求排队吞吐上不去。乐观锁更适合购书商城这种并发不算极端的场景UPDATE stock SET quantity quantity - #{num}, version version 1 WHERE book_id #{bookId} AND quantity #{num} AND version #{version};返回影响行数为 0 就说明库存不足或版本冲突业务层重试或直接提示。quantity #{num}这个条件很关键它把库存够不够的判断和扣减合成一条原子 SQL避免了先查后扣之间的时间窗口。我一般会设 3 次重试超过就返回库存紧张请重试。4. Mybatis 映射与 Thymeleaf 渲染把数据送到页面4.1 Mapper 接口与 XML 的配合Mybatis 的用法是接口定义方法XML 写 SQL。以图书查询为例Mapper public interface BookMapper { ListBook selectByCategory(Param(categoryId) Integer categoryId, Param(offset) Integer offset, Param(limit) Integer limit); Book selectById(Param(id) Long id); }select idselectByCategory resultTypecom.example.bookstore.entity.Book SELECT id, book_name, author, price, cover_url, category_id FROM book WHERE category_id #{categoryId} AND status 1 ORDER BY create_time DESC LIMIT #{offset}, #{limit} /selectParam注解给参数起名XML 里用#{categoryId}引用。多个参数时一定要加否则 Mybatis 只能用arg0、param1这种默认名可读性差还容易写错。分页用LIMIT offset, limitoffset 是跳过的行数limit 是取多少条别把顺序写反。如果开了map-underscore-to-camel-casebook_name会自动映射到bookName不用写resultMap。但涉及多表关联、字段名冲突时还是老老实实写resultMap更稳。4.2 Thymeleaf 列表渲染与分页Controller 把数据塞进ModelThymeleaf 负责渲染GetMapping(/books) public String list(RequestParam(defaultValue 1) Integer page, RequestParam(defaultValue 0) Integer categoryId, Model model) { int size 12; int offset (page - 1) * size; ListBook books bookMapper.selectByCategory(categoryId, offset, size); model.addAttribute(books, books); model.addAttribute(page, page); model.addAttribute(categoryId, categoryId); return book/list; }!-- templates/book/list.html -- div classbook-grid div classbook-card th:eachbook : ${books} img th:src${book.coverUrl} alt封面/ h3 th:text${book.bookName}书名/h3 p th:text ${book.price}价格/p a th:href{/cart/add(bookId${book.id})}加入购物车/a /div /div div classpager a th:href{/books(page${page - 1}, categoryId${categoryId})} th:if${page 1}上一页/a a th:href{/books(page${page 1}, categoryId${categoryId})}下一页/a /divth:each遍历集合th:text输出文本th:href用{...}语法拼 URL 并自动处理上下文路径。${book.price}直接输出会有精度问题实际项目里建议用#numbers.formatDecimal(book.price, 1, 2)格式化。分页的下一页没做总数判断真实场景要查COUNT(*)算总页数否则最后一页点进去是空的。5. 避坑与排查下单报错、页面不刷新、连接超时5.1 下单时库存扣了但订单没生成现象用户下单后库存减少但订单表查不到记录。原因通常是事务没生效。Transactional加在 Controller 上、或者同类内部方法直接调用都会导致代理失效。解决把事务注解加在 Service 的 public 方法上且确保是通过 Spring 注入的 Bean 调用不是new出来的对象。5.2 改完 HTML 刷新浏览器没变化现象Thymeleaf 页面改了但浏览器还是旧的。原因有两个一是thymeleaf.cache没关二是 IDEA 没开自动编译。解决application.yml里设cache: falseIDEA 里开启Build project automatically再配合CtrlF9手动触发一次编译。这个坑我踩过不止一次排查半天以为是模板语法错其实是缓存。5.3 启动报Access denied for user或时区错误现象应用起不来日志里一堆连接异常。原因数据库密码错、serverTimezone没配、或者 MySQL 8 的认证插件问题。解决先确认application.yml里的账号密码URL 里补上serverTimezoneAsia/Shanghai。如果是Public Key Retrieval is not allowed在 URL 后加allowPublicKeyRetrievaltrue。5.4 中文乱码现象图书名存进去变成问号。原因数据库字符集不是utf8mb4或者连接 URL 没指定编码。解决建库建表时统一用utf8mb4URL 里加useUnicodetruecharacterEncodingutf8。utf8mb4比utf8多支持 emoji图书简介里如果有特殊符号不会丢。5.5 Mybatis 的Invalid bound statement现象启动正常一调 Mapper 就报找不到 SQL。原因mapper-locations路径不对或者 XML 文件名和接口名不一致。解决确认classpath:mapper/*.xml能匹配到文件XML 的namespace必须是接口全限定名id必须和方法名一模一样。这个错误信息很直白照着核对就行。6. 进阶技巧用 Mybatis 二级缓存和 Thymeleaf 片段复用提效图书详情页是读多写少的典型场景每次请求都查库没必要。Mybatis 的二级缓存可以跨 SqlSession 缓存查询结果配置方式是在 XML 顶部加一行cache evictionLRU flushInterval60000 size512 readOnlytrue/evictionLRU用最近最少使用策略淘汰flushInterval是 60 秒自动清一次size限制缓存对象数。注意二级缓存以 namespace 为单位同一 Mapper 下的增删改会自动清空该 namespace 的缓存。但如果你在别的 Mapper 里改了同一张表缓存不会失效所以只建议给纯读、更新频率低的表开缓存比如分类、出版社。图书库存这种频繁变动的开了反而容易读到脏数据。Thymeleaf 的片段复用能省掉大量重复 HTML。把页头、页脚、导航抽成fragment!-- templates/common/header.html -- header th:fragmentheader nav a th:href{/}首页/a a th:href{/cart}购物车/a /nav /header其他页面直接引入div th:replace~{common/header :: header}/divth:replace会用片段整体替换当前标签th:insert则是插入到标签内部。改导航时只动一个文件所有页面同步生效。这个技巧在页面超过五个之后收益非常明显。验证缓存是否生效可以在 Mybatis 配置里打开 SQL 日志mybatis: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl第一次查详情页会打印 SQL第二次如果没打印说明缓存命中了。但记得上线前关掉日志量太大会拖慢性能。最后说个我自己的习惯每加一个新功能先写一条能复现问题的最小 SQL 在数据库客户端里跑通再搬到 Mybatis XML 里。这样出问题时能快速判断是 SQL 本身错了还是映射配置错了。购书商城这类项目真正难的不是框架怎么用而是把库存、订单、事务这几处的边界想清楚。希望帮到你。本文还有配套的精品资源点击获取
网站建设高端定制企业官网