电商练习Demo全攻略:从技术选型到完整业务闭环
简介:这是一份面向电商开发者与初学者的电商项目练习Demo,聚焦电商系统从架构设计到功能落地的完整流程。项目涵盖用户、商品、订单、支付、物流、推荐等核心模块,前端采用Vue/React等现代框架,后端基于Spring Boot或Django,并包含数据库设计、接口安全、性能优化等内容,适合用于课程设计、毕业设计或入职前技能提升。压缩包共1024个文件,以949张png界面截图、53张jpg效果图、16个md说明文档、5个gif演示动画和1个HTML页面为主,整体大小约55.21MB,可通过截图与文档快速还原项目结构。目前已有723人学习下载,适合通过阅读文档、查看演示图逐步理解每个模块的实现思路与交互方式。源码之外,文档中整理了项目结构说明、模块功能拆解和关键交互逻辑,配合流程演示动画能直观看到商品浏览、购物车、订单支付等场景的运行效果,可帮助学习者掌握电商项目中的前后端协作、支付回调、物流对接等技术要点,作为实战练习或二次开发的起点。 我见过太多自学到 Spring Boot、Vue 看完视频就卡在"下一步做什么"的人。跟练了一堆教程,真到自己新建项目时不知道从哪里下手;简历上写着"了解商城项目",被面试官问一句"订单状态怎么流转"就卡壳。而练习项目偏偏选电商 demo 的人最多,因为电商恰好能把这些薄弱环节全部暴露出来。
电商项目之所以是练习首选,不是因为它热门,而是它天然覆盖一条完整业务链路:用户、商品、购物车、订单、支付、库存、后台管理。每一环单独拿出来都不算难,但串起来之后,你就能把一个项目的完整开发流程从头到尾走一遍。这篇文章我准备聊聊怎么把一个电商练习 demo 做得"既不大而全,又能完整跑通演示"——从目标定位、技术选型,到核心模块、表结构设计,再到本地跑通的踩坑记录和面试进阶方向,把我实际做过的东西和踩过的坑一并写出来。
1. 电商练习demo的定位选择:练手重点不是"大而全"
1.1 先想清楚这个demo做给谁看
动笔写代码之前,先把目标想明白。做练习 demo 最常见的问题,是照着"大厂开源项目"的思路无脑堆功能:秒杀、优惠券、分布式锁、消息队列、K8s 编排,最后写了几万行代码,部署却跑不起来,人也学废了。
我给这个 demo 的定位很明确:给正在自学、准备找第一份后端或前端工作的人做一个"能完整跑起来的电商闭环"。它不需要支撑几十万用户,但必须让练习者在开发过程中碰到真实的业务逻辑、设计决策和联调排错。说得直白点,一次走通完整业务闭环,胜过看一百个零散的功能片段。
1.2 两条主线撑起整个闭环
整个 demo 我建议只保留两条业务主线:
- 用户端主线:注册登录 → 浏览商品 → 加入购物车 → 提交订单 → 模拟支付 → 查看订单状态
- 管理端主线:管理员登录 → 维护商品分类 → 新增/上下架商品 → 查看订单列表
这两条线已经能覆盖前后端交互、权限控制、状态机流转、数据一致性和联调排错这些练习核心。等跑通了,再按兴趣扩展搜索、库存优化、数据统计,都是水到渠成的事。我最初自己练的时候,上来就想做"订单拆分"功能,折腾了两周连分布式事务是什么都没搞明白,后来老老实实先做单体,反而学得扎实。
1.3 练习阶段先别碰的"高级货"
练习阶段不建议碰微服务、分布式事务、K8s 这些。原因很现实:这些方案解决的是"人多、流量大、协作复杂"的问题,一个练习项目根本造不出这个场景,硬上只会增加环境成本。
真正重要的是先把一个单体应用做扎实。代码分层怎么分、接口怎么设计、事务边界画在哪、异常怎么处理,这些基本功练好了,后面学分布式才有意义。如果面试时能说清楚"我这个 demo 是单体架构,因为业务规模还不需要微服务,但哪些模块未来可以拆出去",这比背一堆微服务名词加分得多。
2. 技术栈怎么定:照着招聘需求配一套能跑起来的组合
2.1 后端推荐组合与理由
后端我用的是这套:Spring Boot 2.7.18 + MyBatis-Plus 3.5.x + MySQL 8.0 + Redis 5.x,JDK 1.8 或 11。
选这个组合的理由很直接:
- Spring Boot 2.7 对 JDK 8/11 兼容性好,资料多,出问题搜得到答案;
- MyBatis-Plus 省掉大量单表 CRUD 的 XML,能把时间花在业务逻辑上,而不是写重复 SQL;
- Redis 在这个 demo 里主要做验证码存储、登录 token 缓存、首页热点商品缓存,用量恰到好处;
- MySQL 8.0 是当前主流,默认 utf8mb4,中文存储没有字符集坑。
有不少人纠结要不要直接上 Spring Boot 3。我的看法是:如果 JDK 17 和环境配置你都熟,当然可以;但对想快速跑通 demo 的练习者,2.7 更省心。因为很多旧依赖、旧教程都是基于 2.x 写的,遇到兼容问题会非常打击积极性。
2.2 前端推荐组合与理由
前端建议用 Vue 3 + Vite + Element Plus + Pinia + Vue Router + Axios。
Vue 3 的 Composition API 写起来更接近真实项目的组织方式;Pinia 是 Vue 3 官方推荐的状态管理库,比 Vuex 心智负担小,函数式写法人人都能快速上手;Element Plus 直接提供一整套后台管理 UI 组件,表格、表单、弹窗都现成。
如果求职方向是 React,把 Vue 换成 React 18 + Ant Design 5 + zustand 完全等价。核心要练的其实是四件事:组件通信、数据请求封装、路由守卫、全局状态管理,框架只是工具。
2.3 版本环境里常见的坑
几处版本相关的坑提前说,能省大半天调试时间:
- Node.js 别装太新的版本。我踩过 Node 20 配旧版 Vite 报 OpenSSL 错误的坑,要么升级 Vite,要么退回 Node 18 LTS,建议直接装 Node 18 最稳;
- 后端依赖版本别手动乱升。Spring Boot 2.7 已经锁定了大部分依赖版本,单独升某个包很容易引发冲突;
- 前后端端口提前约定好:前端 5173,后端 8080,Redis 6379。联调的时候一看端口就知道在调哪一层,排查问题会快很多。
技术栈选得好不好,直接影响练习效率。选一套"照着招聘 JD 选出来的组合",本身就是练习的一部分。面试官很喜欢问"为什么用这个不用那个",能答出选型理由,比背八股印象好得多。
3. 核心业务模块拆解:商城功能做到什么程度才算"完整"
3.1 用户体系:JWT登录与权限控制
用户模块别只做一个注册登录就完事,一定要把权限控制做进去。我的做法是这样的:
- 用户密码用 BCrypt 加密存储,绝不明文存库;
- 登录成功签发 JWT,前端把 token 存在 localStorage 或 Pinia 里,每次请求放在 Authorization 头;
- 后端用一个拦截器校验 token,解析出用户 ID 放进 ThreadLocal 或请求上下文;
- 管理端接口额外校验角色字段,实现管理员和普通用户访问权限分离。
这样一套做下来,你能顺带搞明白 JWT 结构、拦截器机制、角色权限模型、ThreadLocal 用法这几个高频面试点。代码量不大,但含金量非常高。
3.2 商品模块:分类、列表、详情、搜索
商品模块是练习价值很高的部分,因为它的业务状态足够多:
- 商品分类是典型的"一对多"查询场景,分类表存层级结构;
- 商品列表要支持分页、按分类筛选、按价格/销量排序;
- 商品详情要回显主图、价格、库存、描述等多字段信息;
- "搜索"可以先做成 MySQL LIKE 模糊查询,主流程跑通后再优化。
这个小模块能把分页参数封装、多条件动态查询、VO/DTO 转换这些基本功全部练到。建议接口返回给前端的时候,不要直接丢数据库实体,而是单独定义 VO 对象控制返回字段。比如列表只需要 id、名称、主图、价格,详情才返回完整描述,这样也顺带练到了接口隔离的思想。
3.3 购物车与订单:库存校验时机和价格计算
这一块是电商 demo 里最容易出错也最值得琢磨的环节。
购物车可以用"登录后数据存数据库 cart_item 表"的方式,用户 ID 关联。关键是要处理好几个边界:数量上限设多少、商品下架之后购物车里怎么显示、勾选状态怎么保存。我建议购物车数量增减、勾选、全选这些操作都统一走后端接口保存,避免前端一刷新状态就丢。
订单模块建议分两大步:
- 下单接口做三件事:从购物车取出选中商品、校验库存和价格、创建订单和订单明细;
- 生成的订单初始状态为"待支付",然后调用模拟支付接口,支付成功后把订单状态改为"已支付"。
价格计算这里有个非常重要的原则: 绝对不要用前端传来的价格 ,要在后端根据数据库里的商品价格重新计算。很多新手觉得"都是自己的接口,无所谓",但真实电商这是底线逻辑,前端的任何数据都可以被篡改。养成从源头信任数据库的习惯,后面做真实项目才不会出事故。
3.4 支付模块:不接真实支付,怎么模拟流程
练习项目不需要真的接微信/支付宝,但可以先把真实的支付交互流程模拟出来:
- 创建订单之后返回一个"支付页面"或"支付二维码弹窗";
- 用户点击"模拟支付成功",前端调后端支付接口;
- 支付接口做订单状态校验、更新订单状态、记录支付流水号。
可以顺手加一个"支付成功回调"逻辑:支付成功后触发一次回调方法,更新订单状态。真实支付的核心难点就是"回调通知必须幂等",同一个支付结果通知多少次,业务只能处理一次。把这个思路在 demo 里写清楚,面试时提到"模拟回调幂等"会非常有亮点。
4. 数据模型设计:7张表怎么撑起一个电商闭环
4.1 核心表结构与关系
我的练习 demo 里只用了 7 张核心表:
| 表名 | 关键字段 | 作用 |
|---|---|---|
| user | id, username, password, nickname, role | 用户与权限 |
| category | id, name, parent_id, sort | 商品分类树 |
| product | id, category_id, name, price, stock, status | 商品基本信息 |
| cart_item | id, user_id, product_id, quantity, checked | 购物车数据 |
| orders | id, order_no, user_id, total_amount, status | 订单主表 |
| order_item | id, order_id, product_id, price, quantity | 订单快照明细 |
| payment | id, payment_no, order_id, amount, status | 支付流水 |
表之间要不要用物理外键?练习阶段建议不用,用逻辑关联就好。理由有两个:第一,真实电商项目(尤其高并发场景)很少用物理外键,避免数据库层面的锁和校验开销;第二,练习过程中造数据、删数据更方便,不会因为外键约束卡住。但 user_id、product_id 这类逻辑外键字段一定不能少。
order_item 表特意存了商品名称、图片、单价这些快照信息。这是因为订单生成后,商品表里的价格可能变,名称可能改,但订单明细必须保持下单那一刻的快照。这个概念叫"业务快照",也是真实电商里的标准做法。
4.2 订单号怎么生成、状态怎么流转
订单号不要用数据库自增 ID,要生成业务单号。我一般这样写:
// 格式:O + 时间戳 + 用户ID后四位 + 随机三位数
String orderNo = "O" + System.currentTimeMillis()
+ String.format("%04d", userId % 10000)
+ String.format("%03d", new Random().nextInt(1000));
这样生成的单号可读性还可以,同用户同时段重复概率极低,练习足够用。想更严谨可以用雪花算法,但 demo 阶段没必要引入额外依赖。
订单状态用整型枚举存储(0 待支付、1 已支付、2 已发货、3 已完成、4 已取消),API 返回时再转中文描述。好处是数据库排序快、索引友好,也给后面扩展状态留了空间。状态流转务必遵循:待支付 → 已支付 → 已发货 → 已完成,取消只能在待支付阶段做,千万别写成可以乱跳的状态机。
4.3 金额计算的精度处理
金额字段必须用 decimal,不能用 double/float。购物车金额累加、订单总价计算、支付金额校验,全部用 BigDecimal。新手最容易忽视这点,但这是真实项目的硬要求——浮点数算钱会出大事。
后端计算订单总价的示例写法:
BigDecimal totalAmount = orderItems.stream()
.map(item -> item.getPrice().multiply(new BigDecimal(item.getQuantity())))
.reduce(BigDecimal.ZERO, BigDecimal::add);
5. 前端联调的几处关键交互设计
5.1 登录状态管理与路由守卫
前端联调时最需要先处理的是登录状态。Axios 封装一个请求实例,在请求拦截器里统一加 token,在响应拦截器里统一处理 401:
// request.js 核心拦截逻辑
service.interceptors.request.use(config => {
const token = localStorage.getItem('token')
if (token) {
config.headers.Authorization = `Bearer ${token}`
}
return config
})
service.interceptors.response.use(
res => res.data,
err => {
if (err.response && err.response.status === 401) {
router.push('/login')
}
return Promise.reject(err)
}
)
路由守卫负责未登录跳转:访问购物车、结算页这类需要登录的页面时,判断没有 token 或 token 过期,直接 redirect 到 /login。前端这套和后端 JWT 校验配合起来,登录闭环才算完整。
5.2 购物车数量同步与选中态管理
购物车页面最容易出的问题是状态错乱。我的经验是:数量增减、勾选、全选全部统一操作 Pinia 里的购物车 store,每个操作同时更新"本地展示状态"和"后端数据",不做零散的局部变量。这样下单前读到的数据一定是最新的,不用反复刷新页面。
5.3 订单结算流程的页面状态
结算流程一般是三步:确认订单页 → 模拟支付页 → 支付结果页。这里有一个很实际的体验问题:用户点"提交订单"后,按钮要立刻进入 loading 状态并禁用,防止重复点击造成重复下单。
后端也建议做一个幂等兜底,可以给 orders 表加唯一索引,或者生成一个前端提交时的请求令牌。但不管后端怎么兜底,前端先把体验控制住,逻辑和交互都更稳。
6. 本地跑通与演示环境的踩坑记录
6.1 数据库初始化与数据填充
我自己初跑这个 demo 时,卡得最久的就是数据库初始化和模拟数据。建议把建表 SQL 和基础数据(几个分类、十几件有真实感的商品)写成 init.sql,在项目里放一份。别人拿到项目不用手动造数,这是一份合格 demo 的基本素质。
模拟数据有一招很好用:商品图片先用网络占位图,比如 https://picsum.photos/seed/xxx/400/400 ,能正常显示就行。等有空再换成自己准备的本地静态资源,不影响主流程开发。
6.2 跨域配置
前端 5173、后端 8080 一定有跨域问题。最简单的解决方式是后端加一个全局 CORS 配置:
@Configuration
public class CorsConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**")
.allowedOriginPatterns("http://localhost:*", "http://127.0.0.1:*")
.allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")
.allowCredentials(true)
.maxAge(3600)
}
}
如果你同时配了 JWT 拦截器,预检 OPTIONS 请求一定要放行,否则前端会报"跨域被拦截",这是联调阶段最常见的坑之一。
6.3 启动顺序与常见报错排查
整个 demo 的启动顺序是:先启动 MySQL 和 Redis,再启动后端,最后启动前端。
遇到"端口被占用"时不要慌,找到占用进程关掉,或者临时改端口都行。我建议把本地 MySQL 和 Redis 设置成开机自启,省得每次调试都要手动开服务。
6.4 一个完整的联调报错排查链路
举一个我印象最深的报错:前端登录成功后,请求商品列表一直 401。当时我的排查链路是这样的:
- 先开浏览器 Network,确认请求头里有没有带 Authorization,结果发现带了;
- 再看后端拦截器配置,发现自己把
/login接口放行了,但没放行/api/xx路径下的部分静态请求,请求被打回; - 继续深挖,发现拦截器里没有放行 OPTIONS 预检请求,POST 请求被 CORS 策略卡住。
整个链路走下来,前端、后端、协议三层的问题都碰到了。虽然花了两个小时,但比看十篇八股文都有用。排查顺序我总结成一句话:先看请求发没发出去,再看请求头对不对,最后看后端拦没拦。
7. 从demo到面试作品的进阶打磨方向
7.1 Redis 缓存:第一优先级的增强
主流程跑通之后,我建议第一个增强就是加 Redis 缓存。至少做两件事:
- 首页商品列表缓存:把热点商品列表缓存到 Redis,设置 5 分钟过期,并做一层空值缓存防穿透;
- 登录 token 改存 Redis,设置过期时间,实现"退出登录即失效"。
这两处改动会逼着你理解缓存一致性、过期策略和登录态管理,都是面试高频点。
7.2 并发扣减库存的优化思路
demo 不用真的做高并发压测,但可以留一个"防超卖"的优化思路:下单扣库存时,用一条条件更新 SQL:
update product set stock = stock - #{num}
where id = #{id} and stock >= #{num}
如果影响行数不等于 1,说明库存不足,下单失败。这个写法的巧妙之处在于,把"查库存"和"更新库存"合并成一条原子操作,天然避免并发超卖。在代码里先实现这版,然后在 README 里写清楚为什么这样写更安全,面试时这就是实打实的技术亮点。
7.3 项目文档和演示准备
这个阶段一定要写 README 和录制演示视频。README 至少包含:项目简介、技术栈、功能列表、启动步骤、表结构说明、演示账号。很多练习者代码写得不错,但忘了"让别人快速跑起来"也是一种能力,面试官拿到项目第一个动作就是照着 README 跑,跑不通就扣分。
7.4 后续扩展的推荐顺序
如果还有精力,可以按这个顺序加功能:管理员端商品图片上传 → 多商品组合下单 → 订单超时自动取消 → 商品搜索改造成全文检索。每加一个功能就写一段更新记录,整个项目的演进过程本身就是最好的成长证明。
我个人体会是,电商练习 demo 不应该是一个"做完就扔"的作业,它最好的状态是一个能持续迭代的长期项目。刚开始只求跑通闭环,后面每学到新东西都往里放一点。等这个项目能完整演示、文档清晰、还能讲清楚每一个设计决策的时候,它就不再是"练习 demo",而是简历上真正拿得出手的实战项目了。
更多推荐




所有评论(0)