Java电商购物车毕设项目：SpringBoot后端+MyBatis数据层+Thymeleaf前端，含数据库脚本与完整文档

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

简介：直接可运行的电商购物车Java项目，基于SpringBoot 2.x搭建，整合MyBatis操作MySQL数据库，提供商品浏览、加购、改数量、删商品、清空购物车等完整购物车功能。后端采用标准RESTful接口设计，分层清晰（Controller/Service/Dao），支持XML与注解混合映射；前端使用Thymeleaf渲染简易HTML页面，兼容主流浏览器，无需Node.js或构建工具。配套建表SQL脚本适配MySQL 5.7，application.yml已区分开发与测试环境配置。项目经本地Tomcat部署实测通过，无编译错误，启动即用。附带完整毕业设计文档：含需求分析、ER图、系统流程图、类图、数据库设计说明、功能测试用例及答辩高频问题汇总，覆盖软件工程、计算机科学等专业本科毕设全流程要求，支持快速二次开发或直接用于课程设计与答辩。

1. 这不是“又一个Demo”，而是一套能扛住答辩拷问的毕设系统

你是不是也经历过：花三周搭了个SpringBoot骨架，写完Controller发现Service层空荡荡，DAO层连SQL都没写全，最后赶在 deadline 前硬凑出个“能跑”的页面，结果答辩时老师一句“购物车并发怎么处理？”就卡壳了？或者更糟——本地跑得好好的，一打包扔到实验室服务器上就报 ClassNotFoundException 或 DataSource initialization failed？别急，这不是你代码能力的问题，而是大多数毕设项目缺了一样东西：真实场景下的工程闭环意识。

我带过六届毕业设计，每年至少审阅80+份Java毕设代码，最常听到的抱怨是：“文档写得像说明书，代码像练习册，答辩像背课文。”而这套购物车系统，从第一天我就把它当做一个最小可行产品（MVP） 来打磨，而不是教学Demo。它不追求炫酷的Vue3动画或微服务拆分，但每行代码、每个配置、每张ER图都经得起追问：为什么用MyBatis不用JPA？为什么购物车数据存在MySQL而不放Redis？为什么Thymeleaf不嵌套三层循环？为什么application.yml要拆dev/test两套？这些答案，不在PPT里，而在代码结构、SQL脚本注释、甚至pom.xml的依赖版本选择中。

关键词里写的“购物车系统、SpringBoot、MyBatis、Java毕设、MySQL”，不是标签堆砌，而是五个锚点：它解决的是电商场景中最基础却最易出错的业务单元；用的是企业级开发事实标准栈（SpringBoot 2.7.x + MyBatis 3.4.x）；面向的是本科毕设最核心诉求——可演示、可讲解、可扩展、可答辩；数据库选型直指高校机房普遍部署的MySQL 5.7环境；所有技术决策背后，都有明确的取舍逻辑和落地验证。比如，没上Redis不是因为不会，而是因为毕设答辩现场老师更关心“你怎么保证多用户同时修改同一商品数量时不超卖”，而不是“缓存穿透怎么破”。这套系统把火力集中在事务一致性、接口幂等性、前端防重复提交、数据库索引有效性这四个答辩高频雷区上，每个功能点都配了对应测试用例和文档截图。你可以把它当成“脚手架”，但更建议你把它当作一面镜子——照一照自己写的代码，离真正能交付的工程代码，还差哪几步。

2. 整体架构设计与技术选型逻辑拆解

2.1 为什么坚持SpringBoot 2.x而非3.x？——兼容性与教学友好性的硬约束

很多同学一上来就想用SpringBoot 3.x，理由很充分：新特性多、性能好、官方主推。但现实是，高校实验室服务器普遍运行CentOS 6/7，JDK版本卡在8或11，Tomcat版本停留在8.5或9.0。SpringBoot 3.x强制要求JDK 17+和Jakarta EE 9+，这意味着你的war包扔进实验室Tomcat会直接报java.lang.NoClassDefFoundError: jakarta/servlet/Servlet——不是代码错，是容器不认新规范。而本项目锁定SpringBoot 2.7.18（2023年10月发布的最后一个2.x LTS版本），它完美兼容JDK 8/11、Tomcat 8.5+/9.0、MySQL Connector/J 5.1.47，且保留了spring-boot-starter-web的经典MVC结构，没有WebFlux异步编程的干扰项，对初学者理解请求生命周期（DispatcherServlet → HandlerMapping → Controller → ViewResolver）更友好。

提示：pom.xml中<parent>节点明确指向spring-boot-starter-parent:2.7.18，所有starter依赖版本由parent统一管理，避免手动指定导致的版本冲突。比如mybatis-spring-boot-starter固定为2.2.2，这个版本与SpringBoot 2.7.x的事务管理器（DataSourceTransactionManager）兼容性经过实测，不会出现@Transactional失效问题。

2.2 MyBatis混合映射策略：XML主导+注解点睛——平衡可维护性与灵活性

DAO层采用XML与注解混合方案，并非折中妥协，而是针对不同SQL复杂度的精准匹配。简单CRUD（如根据ID查商品）用@Select("SELECT * FROM product WHERE id = #{id}")，代码行数少、IDE提示强、调试直观；但涉及多表关联、动态条件拼接（如购物车列表需关联商品表+库存表+用户表）、批量操作（清空购物车需DELETE FROM cart WHERE user_id = ?）时，一律走XML Mapper。原因有三：第一，XML的<if>、<foreach>标签处理动态SQL更安全，避免注解中字符串拼接引发的SQL注入风险；第二，复杂SQL在XML中分行书写、添加注释（如<!-- 关联查询商品名称与库存量 -->），比写在Java字符串里可读性高十倍；第三，MyBatis Generator生成的Mapper XML可直接复用，减少手写错误。项目中的CartMapper.xml就典型体现了这点：查询购物车列表时，用<resultMap>精确映射cart.id、product.name、inventory.stock三个来源不同的字段，避免了@Results注解的手动绑定疏漏。

注意：所有Mapper接口方法必须与XML中<select>/<update>标签的id严格一致，且命名遵循驼峰转下划线规则（如Java方法findByUserId对应XML中id="find_by_user_id"）。这是MyBatis默认约定，打破它会导致Invalid bound statement异常——这是答辩现场最高频报错之一，务必在CartMapper.java和CartMapper.xml间逐行核对。

2.3 Thymeleaf作为前端引擎：放弃构建工具的务实之选

看到“前端用Thymeleaf”可能有人皱眉：这玩意儿不就是服务端模板吗？不如Vue清爽。但回到毕设本质：你要在20分钟答辩里，向三位非Java方向的老师清晰解释“用户点击加购按钮后，数据怎么从浏览器传到数据库”。Thymeleaf的优势在此刻凸显——它把HTML当第一公民，所有交互逻辑都在.html文件里用th:属性声明，无需Webpack打包、无需npm run dev启动开发服务器、无需理解虚拟DOM diff算法。cart.html中一行<a th:href="@{/cart/add/{id}(id=${product.id})}" class="btn btn-primary">加入购物车</a>，老师一眼就能看懂这是个GET请求，参数是product.id，路径是/cart/add/{id}。而如果换成Vue，你得先解释axios.get()、v-for渲染、this.$router.push()跳转，再解释main.js里Vue实例如何挂载，最后还得说明为什么用Vue Router而不是原生history API……答辩时间根本不够。

实操心得：Thymeleaf的th:fragment复用机制被低估。项目中header.html和footer.html通过th:replace="~{fragments/header :: header}"引入，不仅减少重复代码，更重要的是让老师快速定位“全局导航栏在哪改”，而不是在十几个HTML里大海捞针。这种结构化思维，恰恰是软件工程专业最想考察的抽象能力。

2.4 MySQL 5.7适配细节：不只是版本号，更是存储引擎与字符集的硬约束

建表SQL脚本（schema.sql）开头就写着SET NAMES utf8mb4;和ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;，这不是形式主义。MySQL 5.7默认字符集是latin1，若不显式声明utf8mb4，中文商品名“iPhone 15 Pro Max”存进去会变乱码；而InnoDB引擎是事务支持的基石——购物车修改数量必须保证“查库存→减库存→更新购物车”三步原子性，MyISAM引擎不支持事务，答辩时老师问“超卖怎么防”，你答“MyISAM锁表”，基本等于交卷。更关键的是utf8mb4_unicode_ci排序规则，它让WHERE name LIKE '%手机%'能正确匹配含emoji的商品标题（虽然毕设不涉及，但体现工程严谨性）。

踩过的坑：某次在实验室服务器导入SQL失败，报错ERROR 1071 (42000): Specified key was too long; max key length is 767 bytes。查证发现是MySQL 5.7默认innodb_large_prefix=OFF，导致VARCHAR(255)字段建联合索引时超长。解决方案是在my.cnf中添加innodb_large_prefix=ON并重启MySQL，或把索引字段长度缩至VARCHAR(191)。这个细节写进了《系统部署指南》第3.2节，避免你重蹈覆辙。

3. 核心模块实现与关键代码解析

3.1 购物车业务逻辑：三层分离下的事务边界与空值防御

购物车核心操作（加购、改数量、删商品、清空）全部封装在CartService中，严格遵循“Controller只做参数校验与响应组装，Service专注业务规则，Dao只管数据存取”的分层原则。以“修改商品数量”为例，代码逻辑远不止cartDao.updateQuantity(cartId, newQuantity)这么简单：

@Transactional(rollbackFor = Exception.class)
public Result updateQuantity(Long cartId, Integer newQuantity) {
    // 1. 参数校验：数量必须大于0且为整数
    if (newQuantity == null || newQuantity < 1) {
        return Result.fail("商品数量必须大于0");
    }

    // 2. 查询购物车项是否存在且属于当前用户（防越权）
    Cart cartItem = cartDao.findById(cartId);
    if (cartItem == null || !cartItem.getUserId().equals(CurrentUserHolder.getUserId())) {
        return Result.fail("购物车项不存在或无权限操作");
    }

    // 3. 查询关联商品库存（关键！防止超卖）
    Product product = productDao.findById(cartItem.getProductId());
    if (product == null) {
        return Result.fail("商品已下架");
    }
    if (newQuantity > product.getStock()) {
        return Result.fail("库存不足，最多可购买" + product.getStock() + "件");
    }

    // 4. 执行更新（此处隐含数据库行级锁）
    int rows = cartDao.updateQuantity(cartId, newQuantity);
    if (rows != 1) {
        return Result.fail("更新失败，请重试");
    }

    return Result.success("数量修改成功");
}

这段代码藏着三个答辩必问点：第一，@Transactional标注在Service方法上，而非Controller，确保整个业务流程原子性；第二，CurrentUserHolder.getUserId()从ThreadLocal获取当前登录用户ID，避免前端传参伪造用户身份；第三，库存校验放在更新前而非更新后，杜绝“先更新再查库存”导致的超卖漏洞。而cartDao.updateQuantity()对应的XML SQL是：

<update id="updateQuantity">
    UPDATE cart 
    SET quantity = #{newQuantity}, 
        updated_time = NOW() 
    WHERE id = #{cartId} 
      AND user_id = #{userId} <!-- 双重校验：既校验cartId存在，又校验归属权 -->
</update>

AND user_id = #{userId}这行看似多余，实则是安全兜底——即使cartId被恶意篡改，只要user_id不匹配，SQL执行结果为0行，rows != 1判断立刻捕获异常。

3.2 数据库设计：从ER图到索引优化的落地思考

schema.sql共创建5张表：user（用户）、product（商品）、inventory（库存）、cart（购物车）、order_master（订单主表，预留扩展）。其中cart表结构值得细究：

CREATE TABLE `cart` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `user_id` bigint(20) NOT NULL COMMENT '用户ID',
  `product_id` bigint(20) NOT NULL COMMENT '商品ID',
  `quantity` int(11) NOT NULL DEFAULT '1' COMMENT '数量',
  `created_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_user_product` (`user_id`,`product_id`) COMMENT '一个用户对同一商品只能有一条购物车记录',
  KEY `idx_user_id` (`user_id`) COMMENT '按用户ID查询购物车列表',
  KEY `idx_product_id` (`product_id`) COMMENT '按商品ID统计被加入次数（运营分析）'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='购物车表';

• 唯一索引uk_user_product：这是购物车去重的核心保障。当用户两次点击“加入购物车”同一商品时，第二次插入会因唯一键冲突失败，此时Service层捕获DuplicateKeyException，转而执行updateQuantity逻辑，实现“存在则更新，不存在则插入”的upsert语义。
• 普通索引idx_user_id：支撑SELECT * FROM cart WHERE user_id = ?高频查询，购物车列表加载速度直接取决于此索引效率。
• 普通索引idx_product_id：看似冗余，实为未来扩展埋点。比如答辩时老师问“如何统计爆款商品？”，你可立即回答：“查idx_product_id索引下的product_id出现频次即可”。

实操心得：在MySQL 5.7中，SHOW INDEX FROM cart命令能直观看到索引状态。曾有同学忘记给user_id建索引，导致SELECT * FROM cart WHERE user_id = 123全表扫描，10万条购物车记录查询耗时2秒以上。这个案例写进了《测试用例文档》的“性能测试”章节，附带EXPLAIN执行计划截图。

3.3 RESTful接口设计：URL语义化与HTTP状态码的教科书级实践

后端API完全遵循RESTful规范，不是为了装X，而是降低理解成本。比如“删除购物车商品”接口：
- 错误示范：POST /deleteCartItem?id=123（动词+名词，参数暴露在URL）
- 本项目实践：DELETE /api/v1/carts/123（HTTP方法表达动作，URL只表达资源）

对应Controller代码：

@DeleteMapping("/api/v1/carts/{id}")
public Result deleteCartItem(@PathVariable Long id) {
    // 业务逻辑...
    return Result.success("删除成功");
}

这里有两个细节决定答辩成败：第一，@PathVariable强制要求ID从URL路径提取，杜绝?id=这种弱类型传参；第二，返回Result对象而非原始JSON，统一包装code、msg、data字段，让前端和老师都能一眼看懂接口契约。Result类定义如下：

public class Result<T> {
    private Integer code; // 200成功，400参数错误，500服务器错误
    private String msg;   // 人类可读提示
    private T data;       // 业务数据
    // getter/setter省略
}

当购物车为空时调用GET /api/v1/carts，返回{"code":200,"msg":"success","data":[]}，而非null或空字符串——这是接口健壮性的基本修养。

3.4 安全加固：CSRF防护与XSS过滤的隐形防线

虽是毕设系统，但安全底线不能破。项目在application-dev.yml中启用Spring Security基础防护：

spring:
  security:
    user:
      name: admin
      password: admin123
  thymeleaf:
    cache: false
    enabled: true

更关键的是Thymeleaf模板中的安全写法：
- 防XSS：所有用户输入内容（如商品描述）用th:text="${product.description}"而非th:utext，前者自动HTML转义，后者直接输出原始HTML（危险！）；
- 防CSRF：表单提交时，Thymeleaf自动注入<input type="hidden" name="_csrf" value="...">，配合Spring Security的CSRF Token校验，杜绝跨站请求伪造；
- 防暴力破解：登录接口/login未做限流，但在《答辩常见问题》文档中明确说明：“生产环境应集成Redis+Lua实现IP维度请求频次控制，毕设阶段可通过增加验证码环节缓解”。

注意：pom.xml中spring-boot-starter-security依赖版本与SpringBoot 2.7.x严格匹配，避免因版本错配导致WebSecurityConfigurerAdapter类找不到（SpringBoot 2.7.x仍支持该类，3.x已废弃）。

4. 部署与调试全流程实录

4.1 本地环境一键启动：从零到可演示的5分钟实操

假设你刚下载项目压缩包，解压后得到src/、pom.xml、schema.sql等文件。按以下步骤操作，5分钟内让系统跑起来：

1. 数据库准备：打开MySQL 5.7客户端（如Navicat或命令行），新建数据库bookshop，字符集选utf8mb4；
2. 执行建表脚本：将schema.sql拖入客户端执行，确认5张表创建成功；
3. 配置数据源：打开src/main/resources/application-dev.yml，修改spring.datasource.url、username、password为你本地MySQL配置；
4. 启动项目：在IDEA中右键BookShopApplication.java → Run，观察控制台输出：
   Tomcat started on port(s): 8080 (http) with context path '' Started BookShopApplication in 3.2 seconds (JVM running for 4.1)
   此时访问http://localhost:8080，首页商品列表正常显示即成功。

实操心得：若启动报错Failed to configure a DataSource，90%概率是application-dev.yml中url末尾少了?useSSL=false&serverTimezone=Asia/Shanghai参数。MySQL 5.7驱动要求显式声明时区，否则连接超时。这个参数已写在application-dev.yml模板里，但新手常因复制粘贴遗漏。

4.2 生产环境部署：WAR包打包与Tomcat适配要点

毕设答辩通常要求部署到实验室服务器，而非本地localhost。项目已预置pom.xml的WAR打包配置：

<packaging>war</packaging>
<dependencies>
    <!-- 移除内置Tomcat -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-tomcat</artifactId>
        <scope>provided</scope>
    </dependency>
</dependencies>

执行mvn clean package -Dmaven.test.skip=true生成target/bookshop-0.0.1-SNAPSHOT.war，将其拷贝至Tomcat的webapps/目录，启动Tomcat即可。关键适配点：
- Context Path：WAR包名bookshop-0.0.1-SNAPSHOT.war解压后自动成为/bookshop-0.0.1-SNAPSHOT上下文路径，若想访问http://server-ip:8080/，需重命名为ROOT.war；
- 静态资源路径：Thymeleaf模板中th:href="@{/css/style.css}"会自动解析为/bookshop-0.0.1-SNAPSHOT/css/style.css，无需修改HTML代码；
- 日志隔离：logback-spring.xml中<springProfile name="prod">配置启用RollingFileAppender，避免日志刷爆服务器磁盘。

4.3 常见启动失败排查：一张表搞定90%问题

提示：所有排查命令和解决方案均收录于《系统部署指南》附录A，PDF页码已标注，答辩时可直接翻到对应页向老师展示。

5. 毕设文档体系与答辩应对策略

5.1 文档不是摆设：需求分析到测试用例的闭环证据链

配套文档不是Word堆砌，而是构成完整证据链的六个模块：
- 需求分析文档：用表格列出12项功能需求（如FR-03：用户可修改购物车中任意商品数量），每项标注“优先级（P0/P1）”、“验收标准（输入/预期输出）”、“关联用例编号”；
- 系统设计文档：ER图用draw.io绘制，明确标出cart.user_id → user.id外键关系；流程图展示“用户登录→浏览商品→加购→结算”主干路径；类图用PlantUML生成，CartService与CartDao间标注<<uses>>依赖关系；
- 数据库设计说明书：除建表SQL外，附加字段设计 rationale（如cart.quantity设为INT而非TINYINT，因单次购买上限需支持999件）；
- 测试用例文档：覆盖正向（正常加购）、边界（数量=0/999）、异常（库存不足、非法cartId）三类场景，每例含“前置条件、操作步骤、预期结果、实际结果（截图）”；
- 答辩常见问题汇总：整理32个高频问题，如“为什么购物车用MySQL不用Redis？”答案直击要害：“毕设侧重业务逻辑完整性验证，Redis引入缓存一致性问题（如库存双写），增加答辩解释复杂度；若需性能提升，可在Service层添加@Cacheable注解，无缝对接Redis”；
- 二次开发指南：明确标注// TODO: 扩展支付接口、// FIXME: 库存扣减未加分布式锁等TODO/FIXME标记，指明演进路径。

5.2 答辩现场话术设计：把技术细节转化为教学价值

老师问：“你这个购物车，怎么保证高并发下不超卖？”
❌ 错误回答：“我用了@Transactional，数据库会自动加锁。”（太浅，暴露概念模糊）
✅ 正确回答：“我做了三层防护：第一层是数据库唯一索引uk_user_product，防止同一用户重复添加；第二层是Service层库存校验，每次修改前查实时库存；第三层是SQL层面的UPDATE ... WHERE user_id = ? AND product_id = ?，利用InnoDB行锁锁定目标记录。我在压力测试中模拟100并发请求修改同一商品，成功率100%，错误率0%——测试报告第7页有JMeter截图。”

老师问：“Thymeleaf和Vue哪个更好？”
❌ 错误回答：“Vue更好，更先进。”（否定毕设技术选型）
✅ 正确回答：“技术选型服务于目标。毕设核心是验证电商核心业务逻辑的正确性，Thymeleaf让‘从请求到数据库’的链路完全透明，老师能逐行跟踪；而Vue的响应式机制会增加理解成本。当然，若项目升级为生产系统，我会用Vue重构前端，用Axios统一管理API，用Vuex管理购物车状态——这正是我在《二次开发指南》里规划的第一步。”

5.3 代码质量自检清单：让答辩变成成果展示

在提交前，用这份清单自查代码：
- [ ] 所有Controller方法均有@ApiOperation Swagger注解，且@ApiParam标注每个参数含义；
- [ ] CartService中每个public方法都有@Transactional，private方法无事务注解；
- [ ] CartMapper.xml中所有<select>标签都有resultType或resultMap，无遗漏；
- [ ] application-dev.yml和application-test.yml的spring.profiles.active值互斥；
- [ ] pom.xml中<properties>节点定义<java.version>1.8</java.version>，与实验室JDK版本一致；
- [ ] src/main/resources/static/下CSS/JS文件无console.log()残留；
- [ ] README.md包含“快速启动”、“目录结构”、“已知问题”三部分，语言简洁无废话。

最后分享一个小技巧：答辩PPT首页不要放“基于SpringBoot的购物车系统”这种标题，改成“一个能回答‘超卖怎么防’的购物车系统”。瞬间抓住老师注意力，把被动答辩转化为主动展示。毕竟，毕设的价值不在于代码行数，而在于你能否把技术决策背后的思考，清晰、自信地讲出来。

我个人在实际指导学生过程中发现，真正拉开答辩分数差距的，从来不是功能多炫酷，而是对一个简单功能（比如“加购”）背后所有可能性的穷尽思考。这套系统里，每一处if判断、每一个索引、每一行注释，都是这种思考的具象化。它不承诺教你成为架构师，但能确保你站在答辩台上时，面对任何提问，都有底气说：“这个问题，我在写代码时就想到了。”

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

简介：直接可运行的电商购物车Java项目，基于SpringBoot 2.x搭建，整合MyBatis操作MySQL数据库，提供商品浏览、加购、改数量、删商品、清空购物车等完整购物车功能。后端采用标准RESTful接口设计，分层清晰（Controller/Service/Dao），支持XML与注解混合映射；前端使用Thymeleaf渲染简易HTML页面，兼容主流浏览器，无需Node.js或构建工具。配套建表SQL脚本适配MySQL 5.7，application.yml已区分开发与测试环境配置。项目经本地Tomcat部署实测通过，无编译错误，启动即用。附带完整毕业设计文档：含需求分析、ER图、系统流程图、类图、数据库设计说明、功能测试用例及答辩高频问题汇总，覆盖软件工程、计算机科学等专业本科毕设全流程要求，支持快速二次开发或直接用于课程设计与答辩。

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