本源码适用于个人开发者或小型团队快速搭建轻量级电商后端服务。传统电商开源方案如Magento、WooCommerce功能臃肿、学习成本高，而创业团队通常只需要商品展示、购物车和订单处理等核心功能即可上线最小可行产品。本源码提供一套接口清晰、部署简单、易于二次开发的电商API基础框架，可直接对接微信小程序、UniApp或Vue前端。适合软件外包团队作为电商类项目的开发起点，也适合学习Spring Boot的开发者通过真实业务场景掌握分层架构、事务管理和RESTfulAPI设计的最佳实践。
本源码包含28个Java源文件，按Controller、Service、Mapper三层架构组织，提供20余个RESTful API接口。
1.用户模块——UserController处理登录注册，JwtUtil签发Token，LoginInterceptor校验请求头，WebMvcConfig配置商品浏览接口白名单无需登录。
2.商品模块——ProductController支持分页展示、分类筛选和关键词搜索，ProductService处理库存扣减与回滚，Category实体支持两级分类树结构。
3.购物车模块——CartController提供增删改查接口，CartService实现同商品自动合并数量逻辑，cart_item表采用user_id加product_id联合唯一约束防止重复插入。
4.订单模块——OrderController处理下单、支付、取消全流程，OrderService在一个@Transactional方法中依次完成库存扣减、订单创建、明细写入和购物车清空四个原子操作，取消订单时遍历OrderItem依次回滚所有商品库存。
5.地址模块——AddressController支持多地址增删改及默认地址切换。
6.管理端模块——AdminController提供商品上下架和订单发货、完成接口。附带MySQL建表脚本（7张表含测试数据）、Postman测试集合和README文档。
本人独立完成全部源码开发，包括数据库建模、28个Java类编码、事务逻辑设计和接口测试。采用Spring Boot 3.2加MyBatis-Plus 3.5加MySQL8构建。开发难点有三处：一是下单流程的事务一致性，库存扣减到购物车清空共四个步骤必须在同一事务中原子执行，通过@Transactional注解加事务传播机制保证全部成功或全部回滚；二是取消订单的库存回滚，需遍历OrderItem表逐一恢复对应商品的已扣库存，涉及多表多行更新的事务协调；三是购物车合并逻辑，同一用户重复添加同一商品时不能简单INSERT，需捕获唯一约束冲突后UPDATE数量字段，Service层通过先查后判分支处理。实现亮点：LambdaQueryWrapper实现类型安全的动态查询，避免SQL字符串拼接；统一Result返回格式消除接口对接成本；订单号采用MM加时间戳加随机数策略生成，高并发下仍可保证唯一性。
评论