尧图网页设计 
简介这是一套基于Spring Boot与MySQL实现的游戏周边交易商城系统源码面向计算机专业学生、Java初学者及需要毕业设计或课程设计选题的开发者帮助其快速获得一个功能完整、可部署运行的电商类实战项目。压缩包共632个文件约16.37MB以89个Java类、116个Vue组件、48个HTML页面、43个Jar依赖及32个JSON配置为主另含SQL脚本、图片素材与批处理启动脚本覆盖后端服务、前端界面与数据库初始化。系统包含用户注册登录与JWT鉴权、商品发布与分类管理、购物车增删改、订单创建支付发货确认收货以及普通用户与管理员角色权限控制等模块并附数据库文件与配置说明便于导入运行。目前已有173人学习下载适合借此理解前后端交互、数据库表结构设计与认证支付集成流程提升独立构建同类系统的能力。1. 从零到一游戏周边交易商城到底在做什么如果你正在找一套能跑通、能改、能写进毕业设计论文里的 Spring Boot 项目游戏周边交易商城是个很讨巧的选题。它不像校园讲座预约那样业务单薄也不像餐饮 SaaS 那样复杂到失控。核心链路只有三条用户浏览商品、下单支付、卖家发货。但每条链路背后都藏着库存扣减、订单状态机、并发安全这些能写进论文的硬骨头。我见过太多同学拿到一个压缩包解压后对着几十个文件夹发呆不知道从哪启动也不知道哪些代码是核心。这篇笔记就按一线开发的思路把「基于 Spring Boot MySQL 实现游戏周边交易商城」这件事拆开。你会看到技术选型的理由、数据库表怎么设计、关键接口怎么写、以及那些只有真正跑过才会遇到的坑。适合正在做课程设计或毕业设计、想拿一个能讲清楚的项目去答辩的人。2. 技术选型与数据库设计为什么是 Spring Boot MySQL2.1 选型不是拍脑袋三层架构的落地理由游戏周边交易商城的业务复杂度决定了它不适合用纯 JSP 或者 Servlet 去堆。商品、订单、用户、购物车、支付记录这些实体之间有明确的关联关系用 Spring Boot 的依赖注入和自动配置能省掉大量 XML 配置。MySQL 作为关系型数据库天然适合处理订单和库存这种需要事务保证的场景。具体到版本我一般会选 Spring Boot 2.7.x 配合 MySQL 8.0。Spring Boot 2.7 是 2.x 的最后一个稳定分支社区资料最全遇到问题搜索成本最低。MySQL 8.0 的窗口函数和 CTE 在统计报表里能派上用场比如计算某个游戏品类的月销量排名。JDK 用 1.8 或 11 都行但如果你打算用 Spring Boot 3.xJDK 必须 17 起步而且 javax 包名要换成 jakarta很多老教程的代码直接复制会报错。连接池这块HikariCP 是 Spring Boot 2.x 的默认选择性能足够。但要注意 MySQL 8.0 的 SSL 连接问题本地开发时如果没配证书启动会报javax.net.ssl.SSLException。解决办法是在 JDBC URL 后面加上useSSLfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai。这三个参数缺一不可尤其是allowPublicKeyRetrievalMySQL 8.0 默认的 caching_sha2_password 认证插件需要它。2.2 数据库表设计六张核心表与字段说明游戏周边交易商城的表不用多六张就能撑起完整业务。下面这张表是我在实际项目中反复调整后的结构字段类型和索引都经过验证。表名核心字段说明userid, username, password, nickname, avatar, phone, create_time用户表password 存 BCrypt 哈希productid, name, game_name, category_id, price, stock, cover_img, description, status商品表status 控制上下架categoryid, name, parent_id, sort_order分类表支持二级分类ordersid, order_no, user_id, total_amount, status, address, create_time订单主表status 用枚举order_itemid, order_id, product_id, product_name, price, quantity订单明细冗余商品名和价格cartid, user_id, product_id, quantity, create_time购物车user_id product_id 唯一索引订单明细表里冗余product_name和price是故意的。商品可能改价或下架但历史订单必须保留成交时的快照。这个设计在答辩时是个加分项能体现你对数据一致性的理解。建表时注意几个细节。orders表的order_no要加唯一索引用时间戳加随机数生成避免并发重复。product表的stock字段用int unsigned防止负数。cart表加unique key (user_id, product_id)这样重复添加同一商品时用ON DUPLICATE KEY UPDATE quantity quantity 1就能实现数量累加比先查再插少一次数据库交互。CREATE TABLE product ( id bigint NOT NULL AUTO_INCREMENT, name varchar(128) NOT NULL COMMENT 商品名称, game_name varchar(64) DEFAULT NULL COMMENT 所属游戏, category_id int NOT NULL COMMENT 分类ID, price decimal(10,2) NOT NULL COMMENT 售价, stock int unsigned NOT NULL DEFAULT 0 COMMENT 库存, cover_img varchar(255) DEFAULT NULL COMMENT 封面图, description text COMMENT 详情, status tinyint NOT NULL DEFAULT 1 COMMENT 1上架 0下架, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_category (category_id), KEY idx_game (game_name) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段 SQL 里utf8mb4是必须的游戏周边商品名经常带 emoji 或特殊符号用utf8会插入失败。decimal(10,2)存价格比float精确避免 0.1 0.2 这种浮点误差。索引加在category_id和game_name上因为列表页最常用的筛选条件就是这两个。2.3 项目分层与包结构拿到一个 Spring Boot 项目先看包结构就能判断代码质量。我习惯按controller、service、mapper、entity、dto、vo、config、common来分。entity对应数据库表dto接收入参vo返回前端。不要在 Controller 里直接返回 Entity否则密码字段会泄露。common包里放统一返回结果ResultT、全局异常处理GlobalExceptionHandler、业务异常BizException。这三个东西是项目的地基后面所有接口都靠它们保持返回格式一致。全局异常处理用RestControllerAdvice注解捕获BizException返回业务错误码捕获Exception返回 500 并记录日志。3. 核心功能实现从商品列表到下单扣库存3.1 商品分页查询与多条件筛选商品列表是流量最大的接口写法直接影响用户体验。用 MyBatis-Plus 的Page对象做分页配合LambdaQueryWrapper拼条件。注意game_name的模糊查询要用like但category_id用eq。排序默认按create_time倒序如果用户选了价格排序再切换。GetMapping(/products) public ResultPageProductVO listProducts( RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, RequestParam(required false) String keyword, RequestParam(required false) Integer categoryId, RequestParam(required false) String sortBy) { PageProduct page new Page(pageNum, pageSize); LambdaQueryWrapperProduct wrapper new LambdaQueryWrapper(); wrapper.eq(Product::getStatus, 1); if (StringUtils.hasText(keyword)) { wrapper.and(w - w.like(Product::getName, keyword) .or().like(Product::getGameName, keyword)); } if (categoryId ! null) { wrapper.eq(Product::getCategoryId, categoryId); } if (price_asc.equals(sortBy)) { wrapper.orderByAsc(Product::getPrice); } else if (price_desc.equals(sortBy)) { wrapper.orderByDesc(Product::getPrice); } else { wrapper.orderByDesc(Product::getCreateTime); } PageProduct result productMapper.selectPage(page, wrapper); return Result.success(result.convert(this::toVO)); }wrapper.and(w - ...)这个写法是为了给 or 条件加括号否则 SQL 会变成status 1 and name like ? or game_name like ?优先级错误导致下架商品也被搜出来。convert(this::toVO)把 Entity 转成 VO顺便过滤掉不需要的字段。分页参数pageNum和pageSize要做上限校验比如pageSize最大 50防止有人传 10000 把数据库拖垮。3.2 下单接口事务、行锁与库存扣减下单是整条链路里最容易出问题的地方。用户点「提交订单」时后端要做四件事校验库存、扣减库存、创建订单、清空购物车。这四步必须在同一个事务里任何一步失败都要回滚。库存扣减用UPDATE product SET stock stock - ? WHERE id ? AND stock ?这种写法靠数据库的行锁保证并发安全。不要先SELECT查库存再UPDATE那样在并发下会超卖。MyBatis 的update返回影响行数如果返回 0 说明库存不足直接抛BizException回滚事务。Transactional(rollbackFor Exception.class) public OrderVO createOrder(Long userId, OrderCreateDTO dto) { // 1. 校验地址和商品 ListOrderItemDTO items dto.getItems(); BigDecimal totalAmount BigDecimal.ZERO; ListOrderItem orderItems new ArrayList(); for (OrderItemDTO item : items) { Product product productMapper.selectById(item.getProductId()); if (product null || product.getStatus() 0) { throw new BizException(商品已下架); } // 2. 扣库存靠行锁防超卖 int affected productMapper.deductStock(item.getProductId(), item.getQuantity()); if (affected 0) { throw new BizException(库存不足 product.getName()); } totalAmount totalAmount.add(product.getPrice() .multiply(BigDecimal.valueOf(item.getQuantity()))); OrderItem oi new OrderItem(); oi.setProductId(product.getId()); oi.setProductName(product.getName()); oi.setPrice(product.getPrice()); oi.setQuantity(item.getQuantity()); orderItems.add(oi); } // 3. 创建订单 Orders order new Orders(); order.setOrderNo(generateOrderNo()); order.setUserId(userId); order.setTotalAmount(totalAmount); order.setStatus(OrderStatus.UNPAID.getCode()); order.setAddress(dto.getAddress()); orderMapper.insert(order); // 4. 批量插入明细 orderItems.forEach(oi - oi.setOrderId(order.getId())); orderItemMapper.batchInsert(orderItems); // 5. 清空购物车 cartMapper.deleteByUserIdAndProductIds(userId, items.stream().map(OrderItemDTO::getProductId).collect(Collectors.toList())); return toVO(order, orderItems); }Transactional(rollbackFor Exception.class)里的rollbackFor不能省。Spring 默认只回滚RuntimeException如果抛的是Exception子类但非运行时异常事务不会回滚。generateOrderNo()用System.currentTimeMillis()加ThreadLocalRandom生成格式类似202501151230451234长度 18 位够用且不重复。deductStock的 SQL 写在 Mapper XML 里update iddeductStock UPDATE product SET stock stock - #{quantity} WHERE id #{productId} AND stock #{quantity} /update这条 SQL 在 MySQL 里会对id对应的行加排他锁直到事务提交。并发下单时第二个请求会阻塞等待等第一个事务提交后重新判断stock quantity不满足就返回 0。这就是行锁防超卖的原理。3.3 订单状态机与支付回调订单状态不能随便改要有明确的状态流转。我定义五个状态UNPAID(0)、PAID(1)、SHIPPED(2)、COMPLETED(3)、CANCELLED(4)。允许的流转是未支付→已支付、未支付→已取消、已支付→已发货、已发货→已完成。其他流转一律拒绝。支付回调接口要做签名校验防止伪造通知。虽然毕业设计里通常用模拟支付但把签名校验的代码写进去答辩时能讲出安全考虑。回调里先查订单状态如果已经是PAID就直接返回成功避免重复处理。然后更新订单状态记录支付流水。public void handlePayCallback(String orderNo, String tradeNo, String sign) { // 验签 if (!verifySign(orderNo, tradeNo, sign)) { throw new BizException(签名校验失败); } Orders order orderMapper.selectByOrderNo(orderNo); if (order null) { throw new BizException(订单不存在); } // 幂等已支付直接返回 if (order.getStatus() OrderStatus.PAID.getCode()) { return; } if (order.getStatus() ! OrderStatus.UNPAID.getCode()) { throw new BizException(订单状态异常); } order.setStatus(OrderStatus.PAID.getCode()); order.setPayTime(new Date()); order.setTradeNo(tradeNo); orderMapper.updateById(order); }幂等判断放在最前面这是支付回调的铁律。没有这一步重复通知会导致订单被多次处理虽然这里只是改状态但如果有积分发放或库存回补逻辑就会出大问题。4. 避坑与排查那些只有跑起来才会遇到的问题4.1 启动报错MySQL 连接失败的三种面孔现象一Access denied for user rootlocalhost。原因通常是密码错了或者 MySQL 8.0 的caching_sha2_password插件和旧版驱动不兼容。解决方法是升级mysql-connector-java到 8.0.33 以上或者在 MySQL 里执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 新密码;。现象二Unknown system variable query_cache_size。这是 MySQL 8.0 移除了查询缓存但连接池配置里还在设这个参数。去application.yml里把query_cache_size相关的配置删掉。现象三The server time zone value ???ú±ê×??± is unrecognized。这是时区没设对JDBC URL 里加serverTimezoneAsia/Shanghai即可。如果还不行检查 MySQL 的time_zone变量用SET GLOBAL time_zone 8:00;改掉。4.2 库存扣减的玄学为什么测试没问题上线就超卖血泪经验本地测试时用 Postman 一个个发请求永远测不出并发问题。必须用 JMeter 或ab命令模拟 100 个并发下单同一个商品。如果发现库存变成负数检查三件事deductStock的 SQL 有没有加stock #{quantity}条件事务注解有没有生效同类内部方法调用不走代理数据库引擎是不是 InnoDBMyISAM 不支持行锁。还有一个隐蔽的坑如果productMapper.deductStock返回的影响行数是 1但后面创建订单时抛了异常事务回滚库存会恢复。但如果异常被try-catch吞掉了没往外抛事务不会回滚库存就白白扣了。所以catch块里要么重新抛BizException要么手动TransactionAspectSupport.currentTransactionStatus().setRollbackOnly()。4.3 前端传参的翻车现场日期格式与金额精度前端传createTime时经常传2025-01-15这种字符串后端用Date接收会报JSON parse error。解决办法是在 DTO 字段上加JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8)。如果前端传的是时间戳用JsonFormat(shape JsonFormat.Shape.NUMBER)。金额字段更要注意。前端传19.9后端用Double接收存到数据库变成19.899999999999999。必须用BigDecimal并且在 DTO 里加DecimalMin(0.01)校验。返回给前端时BigDecimal默认序列化成数字如果前端需要字符串格式加JsonSerialize(using ToStringSerializer.class)。4.4 图片上传的路径问题本地能看部署就裂开发时图片存D:/upload/前端用http://localhost:8080/img/xxx.jpg能访问。部署到服务器后路径变成/tmp/tomcat.xxx/upload/重启就丢。正确做法是在application.yml里配一个绝对路径比如file.upload-path/data/upload/然后写一个WebMvcConfigurer把/img/**映射到该路径。Configuration public class WebConfig implements WebMvcConfigurer { Value(${file.upload-path}) private String uploadPath; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/img/**) .addResourceLocations(file: uploadPath); } }注意addResourceLocations里的file:前缀不能少否则 Spring 会当成 classpath 资源去找。路径末尾的斜杠也要加不然拼接会出错。4.5 订单号重复并发下的唯一性陷阱用System.currentTimeMillis()生成订单号在并发下会重复。因为同一毫秒内可能有多个请求。解决办法是加随机数或序列号System.currentTimeMillis() String.format(%04d, ThreadLocalRandom.current().nextInt(10000))。更稳妥的是用 Redis 的INCR生成全局唯一序列但毕业设计里用时间戳加随机数就够了。记得给order_no加唯一索引重复插入会报错而不是静默产生两条相同订单号的记录。5. 进阶技巧让项目在答辩时多拿十分5.1 用 AOP 记录操作日志答辩老师喜欢问「你怎么做日志的」。如果只说log.info就太单薄了。用 Spring AOP 加自定义注解OpLog在切面里记录操作人、操作类型、请求参数、耗时。这样每个增删改接口自动打日志不用在每个方法里手写。Aspect Component public class OpLogAspect { Around(annotation(opLog)) public Object around(ProceedingJoinPoint pjp, OpLog opLog) throws Throwable { long start System.currentTimeMillis(); Object result pjp.proceed(); long cost System.currentTimeMillis() - start; // 异步写入数据库或日志文件 logService.save(opLog.value(), pjp.getArgs(), cost); return result; } }切面里要注意异常处理pjp.proceed()抛异常时也要记录日志否则失败的操作反而没痕迹。日志写入用异步线程池避免拖慢主流程。5.2 接口限流用 Guava RateLimiter 防刷商品列表和下单接口容易被刷。用 Guava 的RateLimiter做一个简单的单机限流每个 IP 每秒最多 10 次请求。在拦截器里判断超过就返回 429。private final LoadingCacheString, RateLimiter limiters CacheBuilder.newBuilder() .expireAfterAccess(10, TimeUnit.MINUTES) .build(new CacheLoaderString, RateLimiter() { Override public RateLimiter load(String key) { return RateLimiter.create(10.0); } }); Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { String ip request.getRemoteAddr(); RateLimiter limiter limiters.getUnchecked(ip); if (!limiter.tryAcquire()) { response.setStatus(429); return false; } return true; }expireAfterAccess让不活跃的 IP 限流器自动过期避免内存泄漏。RateLimiter.create(10.0)表示每秒生成 10 个令牌tryAcquire()非阻塞获取拿不到就拒绝。5.3 数据库连接池参数调优HikariCP 的默认配置在毕业设计里够用但调几个参数能让答辩时更有话说。maximum-pool-size设 10 到 20 之间太大反而增加数据库负担。connection-timeout设 3000 毫秒拿不到连接快速失败。idle-timeout设 600000空闲连接 10 分钟回收。spring: datasource: hikari: maximum-pool-size: 15 minimum-idle: 5 connection-timeout: 3000 idle-timeout: 600000 max-lifetime: 1800000max-lifetime要小于 MySQL 的wait_timeout否则连接被数据库断开后连接池还在用会报Communications link failure。MySQL 默认wait_timeout是 28800 秒设 1800000 毫秒30 分钟是安全的。5.4 一个验证项目是否跑通的小技巧启动项目后不要急着点页面。先用curl调三个接口GET /api/products?pageNum1pageSize5看商品列表是否返回POST /api/cart加购物车POST /api/order/create下单。这三个接口通了说明数据库、事务、JSON 序列化都没问题。然后再打开前端页面看图片能不能加载、分页能不能点、下单后购物车是否清空。我习惯在application.yml里开logging.level.com.你的包名debug这样 MyBatis 打印的 SQL 能直接看到。如果 SQL 没打印检查mybatis-plus.configuration.log-impl是不是设成了org.apache.ibatis.logging.stdout.StdOutImpl。做毕业设计最怕的是项目跑不起来更怕的是跑起来了但讲不清楚。把上面这些点吃透答辩时老师问「库存怎么防超卖」「订单状态怎么流转」「连接池怎么配」你都能接住。希望帮到你。本文还有配套的精品资源点击获取 Spring Boot + MySQL 游戏周边交易商城实战：从数据库设计到库存防超卖
简介这是一套基于Spring Boot与MySQL实现的游戏周边交易商城系统源码面向计算机专业学生、Java初学者及需要毕业设计或课程设计选题的开发者帮助其快速获得一个功能完整、可部署运行的电商类实战项目。压缩包共632个文件约16.37MB以89个Java类、116个Vue组件、48个HTML页面、43个Jar依赖及32个JSON配置为主另含SQL脚本、图片素材与批处理启动脚本覆盖后端服务、前端界面与数据库初始化。系统包含用户注册登录与JWT鉴权、商品发布与分类管理、购物车增删改、订单创建支付发货确认收货以及普通用户与管理员角色权限控制等模块并附数据库文件与配置说明便于导入运行。目前已有173人学习下载适合借此理解前后端交互、数据库表结构设计与认证支付集成流程提升独立构建同类系统的能力。1. 从零到一游戏周边交易商城到底在做什么如果你正在找一套能跑通、能改、能写进毕业设计论文里的 Spring Boot 项目游戏周边交易商城是个很讨巧的选题。它不像校园讲座预约那样业务单薄也不像餐饮 SaaS 那样复杂到失控。核心链路只有三条用户浏览商品、下单支付、卖家发货。但每条链路背后都藏着库存扣减、订单状态机、并发安全这些能写进论文的硬骨头。我见过太多同学拿到一个压缩包解压后对着几十个文件夹发呆不知道从哪启动也不知道哪些代码是核心。这篇笔记就按一线开发的思路把「基于 Spring Boot MySQL 实现游戏周边交易商城」这件事拆开。你会看到技术选型的理由、数据库表怎么设计、关键接口怎么写、以及那些只有真正跑过才会遇到的坑。适合正在做课程设计或毕业设计、想拿一个能讲清楚的项目去答辩的人。2. 技术选型与数据库设计为什么是 Spring Boot MySQL2.1 选型不是拍脑袋三层架构的落地理由游戏周边交易商城的业务复杂度决定了它不适合用纯 JSP 或者 Servlet 去堆。商品、订单、用户、购物车、支付记录这些实体之间有明确的关联关系用 Spring Boot 的依赖注入和自动配置能省掉大量 XML 配置。MySQL 作为关系型数据库天然适合处理订单和库存这种需要事务保证的场景。具体到版本我一般会选 Spring Boot 2.7.x 配合 MySQL 8.0。Spring Boot 2.7 是 2.x 的最后一个稳定分支社区资料最全遇到问题搜索成本最低。MySQL 8.0 的窗口函数和 CTE 在统计报表里能派上用场比如计算某个游戏品类的月销量排名。JDK 用 1.8 或 11 都行但如果你打算用 Spring Boot 3.xJDK 必须 17 起步而且 javax 包名要换成 jakarta很多老教程的代码直接复制会报错。连接池这块HikariCP 是 Spring Boot 2.x 的默认选择性能足够。但要注意 MySQL 8.0 的 SSL 连接问题本地开发时如果没配证书启动会报javax.net.ssl.SSLException。解决办法是在 JDBC URL 后面加上useSSLfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai。这三个参数缺一不可尤其是allowPublicKeyRetrievalMySQL 8.0 默认的 caching_sha2_password 认证插件需要它。2.2 数据库表设计六张核心表与字段说明游戏周边交易商城的表不用多六张就能撑起完整业务。下面这张表是我在实际项目中反复调整后的结构字段类型和索引都经过验证。表名核心字段说明userid, username, password, nickname, avatar, phone, create_time用户表password 存 BCrypt 哈希productid, name, game_name, category_id, price, stock, cover_img, description, status商品表status 控制上下架categoryid, name, parent_id, sort_order分类表支持二级分类ordersid, order_no, user_id, total_amount, status, address, create_time订单主表status 用枚举order_itemid, order_id, product_id, product_name, price, quantity订单明细冗余商品名和价格cartid, user_id, product_id, quantity, create_time购物车user_id product_id 唯一索引订单明细表里冗余product_name和price是故意的。商品可能改价或下架但历史订单必须保留成交时的快照。这个设计在答辩时是个加分项能体现你对数据一致性的理解。建表时注意几个细节。orders表的order_no要加唯一索引用时间戳加随机数生成避免并发重复。product表的stock字段用int unsigned防止负数。cart表加unique key (user_id, product_id)这样重复添加同一商品时用ON DUPLICATE KEY UPDATE quantity quantity 1就能实现数量累加比先查再插少一次数据库交互。CREATE TABLE product ( id bigint NOT NULL AUTO_INCREMENT, name varchar(128) NOT NULL COMMENT 商品名称, game_name varchar(64) DEFAULT NULL COMMENT 所属游戏, category_id int NOT NULL COMMENT 分类ID, price decimal(10,2) NOT NULL COMMENT 售价, stock int unsigned NOT NULL DEFAULT 0 COMMENT 库存, cover_img varchar(255) DEFAULT NULL COMMENT 封面图, description text COMMENT 详情, status tinyint NOT NULL DEFAULT 1 COMMENT 1上架 0下架, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_category (category_id), KEY idx_game (game_name) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段 SQL 里utf8mb4是必须的游戏周边商品名经常带 emoji 或特殊符号用utf8会插入失败。decimal(10,2)存价格比float精确避免 0.1 0.2 这种浮点误差。索引加在category_id和game_name上因为列表页最常用的筛选条件就是这两个。2.3 项目分层与包结构拿到一个 Spring Boot 项目先看包结构就能判断代码质量。我习惯按controller、service、mapper、entity、dto、vo、config、common来分。entity对应数据库表dto接收入参vo返回前端。不要在 Controller 里直接返回 Entity否则密码字段会泄露。common包里放统一返回结果ResultT、全局异常处理GlobalExceptionHandler、业务异常BizException。这三个东西是项目的地基后面所有接口都靠它们保持返回格式一致。全局异常处理用RestControllerAdvice注解捕获BizException返回业务错误码捕获Exception返回 500 并记录日志。3. 核心功能实现从商品列表到下单扣库存3.1 商品分页查询与多条件筛选商品列表是流量最大的接口写法直接影响用户体验。用 MyBatis-Plus 的Page对象做分页配合LambdaQueryWrapper拼条件。注意game_name的模糊查询要用like但category_id用eq。排序默认按create_time倒序如果用户选了价格排序再切换。GetMapping(/products) public ResultPageProductVO listProducts( RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, RequestParam(required false) String keyword, RequestParam(required false) Integer categoryId, RequestParam(required false) String sortBy) { PageProduct page new Page(pageNum, pageSize); LambdaQueryWrapperProduct wrapper new LambdaQueryWrapper(); wrapper.eq(Product::getStatus, 1); if (StringUtils.hasText(keyword)) { wrapper.and(w - w.like(Product::getName, keyword) .or().like(Product::getGameName, keyword)); } if (categoryId ! null) { wrapper.eq(Product::getCategoryId, categoryId); } if (price_asc.equals(sortBy)) { wrapper.orderByAsc(Product::getPrice); } else if (price_desc.equals(sortBy)) { wrapper.orderByDesc(Product::getPrice); } else { wrapper.orderByDesc(Product::getCreateTime); } PageProduct result productMapper.selectPage(page, wrapper); return Result.success(result.convert(this::toVO)); }wrapper.and(w - ...)这个写法是为了给 or 条件加括号否则 SQL 会变成status 1 and name like ? or game_name like ?优先级错误导致下架商品也被搜出来。convert(this::toVO)把 Entity 转成 VO顺便过滤掉不需要的字段。分页参数pageNum和pageSize要做上限校验比如pageSize最大 50防止有人传 10000 把数据库拖垮。3.2 下单接口事务、行锁与库存扣减下单是整条链路里最容易出问题的地方。用户点「提交订单」时后端要做四件事校验库存、扣减库存、创建订单、清空购物车。这四步必须在同一个事务里任何一步失败都要回滚。库存扣减用UPDATE product SET stock stock - ? WHERE id ? AND stock ?这种写法靠数据库的行锁保证并发安全。不要先SELECT查库存再UPDATE那样在并发下会超卖。MyBatis 的update返回影响行数如果返回 0 说明库存不足直接抛BizException回滚事务。Transactional(rollbackFor Exception.class) public OrderVO createOrder(Long userId, OrderCreateDTO dto) { // 1. 校验地址和商品 ListOrderItemDTO items dto.getItems(); BigDecimal totalAmount BigDecimal.ZERO; ListOrderItem orderItems new ArrayList(); for (OrderItemDTO item : items) { Product product productMapper.selectById(item.getProductId()); if (product null || product.getStatus() 0) { throw new BizException(商品已下架); } // 2. 扣库存靠行锁防超卖 int affected productMapper.deductStock(item.getProductId(), item.getQuantity()); if (affected 0) { throw new BizException(库存不足 product.getName()); } totalAmount totalAmount.add(product.getPrice() .multiply(BigDecimal.valueOf(item.getQuantity()))); OrderItem oi new OrderItem(); oi.setProductId(product.getId()); oi.setProductName(product.getName()); oi.setPrice(product.getPrice()); oi.setQuantity(item.getQuantity()); orderItems.add(oi); } // 3. 创建订单 Orders order new Orders(); order.setOrderNo(generateOrderNo()); order.setUserId(userId); order.setTotalAmount(totalAmount); order.setStatus(OrderStatus.UNPAID.getCode()); order.setAddress(dto.getAddress()); orderMapper.insert(order); // 4. 批量插入明细 orderItems.forEach(oi - oi.setOrderId(order.getId())); orderItemMapper.batchInsert(orderItems); // 5. 清空购物车 cartMapper.deleteByUserIdAndProductIds(userId, items.stream().map(OrderItemDTO::getProductId).collect(Collectors.toList())); return toVO(order, orderItems); }Transactional(rollbackFor Exception.class)里的rollbackFor不能省。Spring 默认只回滚RuntimeException如果抛的是Exception子类但非运行时异常事务不会回滚。generateOrderNo()用System.currentTimeMillis()加ThreadLocalRandom生成格式类似202501151230451234长度 18 位够用且不重复。deductStock的 SQL 写在 Mapper XML 里update iddeductStock UPDATE product SET stock stock - #{quantity} WHERE id #{productId} AND stock #{quantity} /update这条 SQL 在 MySQL 里会对id对应的行加排他锁直到事务提交。并发下单时第二个请求会阻塞等待等第一个事务提交后重新判断stock quantity不满足就返回 0。这就是行锁防超卖的原理。3.3 订单状态机与支付回调订单状态不能随便改要有明确的状态流转。我定义五个状态UNPAID(0)、PAID(1)、SHIPPED(2)、COMPLETED(3)、CANCELLED(4)。允许的流转是未支付→已支付、未支付→已取消、已支付→已发货、已发货→已完成。其他流转一律拒绝。支付回调接口要做签名校验防止伪造通知。虽然毕业设计里通常用模拟支付但把签名校验的代码写进去答辩时能讲出安全考虑。回调里先查订单状态如果已经是PAID就直接返回成功避免重复处理。然后更新订单状态记录支付流水。public void handlePayCallback(String orderNo, String tradeNo, String sign) { // 验签 if (!verifySign(orderNo, tradeNo, sign)) { throw new BizException(签名校验失败); } Orders order orderMapper.selectByOrderNo(orderNo); if (order null) { throw new BizException(订单不存在); } // 幂等已支付直接返回 if (order.getStatus() OrderStatus.PAID.getCode()) { return; } if (order.getStatus() ! OrderStatus.UNPAID.getCode()) { throw new BizException(订单状态异常); } order.setStatus(OrderStatus.PAID.getCode()); order.setPayTime(new Date()); order.setTradeNo(tradeNo); orderMapper.updateById(order); }幂等判断放在最前面这是支付回调的铁律。没有这一步重复通知会导致订单被多次处理虽然这里只是改状态但如果有积分发放或库存回补逻辑就会出大问题。4. 避坑与排查那些只有跑起来才会遇到的问题4.1 启动报错MySQL 连接失败的三种面孔现象一Access denied for user rootlocalhost。原因通常是密码错了或者 MySQL 8.0 的caching_sha2_password插件和旧版驱动不兼容。解决方法是升级mysql-connector-java到 8.0.33 以上或者在 MySQL 里执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 新密码;。现象二Unknown system variable query_cache_size。这是 MySQL 8.0 移除了查询缓存但连接池配置里还在设这个参数。去application.yml里把query_cache_size相关的配置删掉。现象三The server time zone value ???ú±ê×??± is unrecognized。这是时区没设对JDBC URL 里加serverTimezoneAsia/Shanghai即可。如果还不行检查 MySQL 的time_zone变量用SET GLOBAL time_zone 8:00;改掉。4.2 库存扣减的玄学为什么测试没问题上线就超卖血泪经验本地测试时用 Postman 一个个发请求永远测不出并发问题。必须用 JMeter 或ab命令模拟 100 个并发下单同一个商品。如果发现库存变成负数检查三件事deductStock的 SQL 有没有加stock #{quantity}条件事务注解有没有生效同类内部方法调用不走代理数据库引擎是不是 InnoDBMyISAM 不支持行锁。还有一个隐蔽的坑如果productMapper.deductStock返回的影响行数是 1但后面创建订单时抛了异常事务回滚库存会恢复。但如果异常被try-catch吞掉了没往外抛事务不会回滚库存就白白扣了。所以catch块里要么重新抛BizException要么手动TransactionAspectSupport.currentTransactionStatus().setRollbackOnly()。4.3 前端传参的翻车现场日期格式与金额精度前端传createTime时经常传2025-01-15这种字符串后端用Date接收会报JSON parse error。解决办法是在 DTO 字段上加JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8)。如果前端传的是时间戳用JsonFormat(shape JsonFormat.Shape.NUMBER)。金额字段更要注意。前端传19.9后端用Double接收存到数据库变成19.899999999999999。必须用BigDecimal并且在 DTO 里加DecimalMin(0.01)校验。返回给前端时BigDecimal默认序列化成数字如果前端需要字符串格式加JsonSerialize(using ToStringSerializer.class)。4.4 图片上传的路径问题本地能看部署就裂开发时图片存D:/upload/前端用http://localhost:8080/img/xxx.jpg能访问。部署到服务器后路径变成/tmp/tomcat.xxx/upload/重启就丢。正确做法是在application.yml里配一个绝对路径比如file.upload-path/data/upload/然后写一个WebMvcConfigurer把/img/**映射到该路径。Configuration public class WebConfig implements WebMvcConfigurer { Value(${file.upload-path}) private String uploadPath; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/img/**) .addResourceLocations(file: uploadPath); } }注意addResourceLocations里的file:前缀不能少否则 Spring 会当成 classpath 资源去找。路径末尾的斜杠也要加不然拼接会出错。4.5 订单号重复并发下的唯一性陷阱用System.currentTimeMillis()生成订单号在并发下会重复。因为同一毫秒内可能有多个请求。解决办法是加随机数或序列号System.currentTimeMillis() String.format(%04d, ThreadLocalRandom.current().nextInt(10000))。更稳妥的是用 Redis 的INCR生成全局唯一序列但毕业设计里用时间戳加随机数就够了。记得给order_no加唯一索引重复插入会报错而不是静默产生两条相同订单号的记录。5. 进阶技巧让项目在答辩时多拿十分5.1 用 AOP 记录操作日志答辩老师喜欢问「你怎么做日志的」。如果只说log.info就太单薄了。用 Spring AOP 加自定义注解OpLog在切面里记录操作人、操作类型、请求参数、耗时。这样每个增删改接口自动打日志不用在每个方法里手写。Aspect Component public class OpLogAspect { Around(annotation(opLog)) public Object around(ProceedingJoinPoint pjp, OpLog opLog) throws Throwable { long start System.currentTimeMillis(); Object result pjp.proceed(); long cost System.currentTimeMillis() - start; // 异步写入数据库或日志文件 logService.save(opLog.value(), pjp.getArgs(), cost); return result; } }切面里要注意异常处理pjp.proceed()抛异常时也要记录日志否则失败的操作反而没痕迹。日志写入用异步线程池避免拖慢主流程。5.2 接口限流用 Guava RateLimiter 防刷商品列表和下单接口容易被刷。用 Guava 的RateLimiter做一个简单的单机限流每个 IP 每秒最多 10 次请求。在拦截器里判断超过就返回 429。private final LoadingCacheString, RateLimiter limiters CacheBuilder.newBuilder() .expireAfterAccess(10, TimeUnit.MINUTES) .build(new CacheLoaderString, RateLimiter() { Override public RateLimiter load(String key) { return RateLimiter.create(10.0); } }); Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { String ip request.getRemoteAddr(); RateLimiter limiter limiters.getUnchecked(ip); if (!limiter.tryAcquire()) { response.setStatus(429); return false; } return true; }expireAfterAccess让不活跃的 IP 限流器自动过期避免内存泄漏。RateLimiter.create(10.0)表示每秒生成 10 个令牌tryAcquire()非阻塞获取拿不到就拒绝。5.3 数据库连接池参数调优HikariCP 的默认配置在毕业设计里够用但调几个参数能让答辩时更有话说。maximum-pool-size设 10 到 20 之间太大反而增加数据库负担。connection-timeout设 3000 毫秒拿不到连接快速失败。idle-timeout设 600000空闲连接 10 分钟回收。spring: datasource: hikari: maximum-pool-size: 15 minimum-idle: 5 connection-timeout: 3000 idle-timeout: 600000 max-lifetime: 1800000max-lifetime要小于 MySQL 的wait_timeout否则连接被数据库断开后连接池还在用会报Communications link failure。MySQL 默认wait_timeout是 28800 秒设 1800000 毫秒30 分钟是安全的。5.4 一个验证项目是否跑通的小技巧启动项目后不要急着点页面。先用curl调三个接口GET /api/products?pageNum1pageSize5看商品列表是否返回POST /api/cart加购物车POST /api/order/create下单。这三个接口通了说明数据库、事务、JSON 序列化都没问题。然后再打开前端页面看图片能不能加载、分页能不能点、下单后购物车是否清空。我习惯在application.yml里开logging.level.com.你的包名debug这样 MyBatis 打印的 SQL 能直接看到。如果 SQL 没打印检查mybatis-plus.configuration.log-impl是不是设成了org.apache.ibatis.logging.stdout.StdOutImpl。做毕业设计最怕的是项目跑不起来更怕的是跑起来了但讲不清楚。把上面这些点吃透答辩时老师问「库存怎么防超卖」「订单状态怎么流转」「连接池怎么配」你都能接住。希望帮到你。本文还有配套的精品资源点击获取