去年九月开学那阵子,学校超市的老板找我诉苦:课间十分钟能涌进来几十个学生,收银台前排长队,还不断有人打电话说“帮我拿瓶可乐送到六号楼”。那一刻我意识到,校园场景里的外卖配送,跟美团饿了么那种商圈外卖完全是两码事——单量不大,但时效要求极高、配送范围高度集中、订单波峰波谷极其明显,通用外卖商家后台根本顶不住这种节奏。
我当时正在做的这个项目,就是一套基于Java的高校超市外卖配送系统,本文聚焦的是其中商家端(也就是超市老板和店员操作的那一端)的完整实现思路。商家端是整个系统里最容易被低估的模块,但实际承担了商品发布、库存管理、订单接收、拣货打包、配送调度这些核心环节,每一块都有不少值得展开的细节。适合正在做校园外卖类课程设计、毕业设计,或者真的想在校内跑一套配送系统的人参考。我会把需求分析、技术选型、数据库设计、状态机、配送逻辑和实战中踩过的坑一次讲清楚。
1. 高校超市外卖的商家端,和普通外卖商家端差在哪
1.1 需求背景:为什么校园外卖不能直接套用通用商家后台
先把场景说透。高校超市和商圈餐厅相比,有几个很特殊的点。
第一,物理距离短。宿舍楼到校内超市一般不超过一公里,绝大多数订单步行五分钟内能送到。这意味着配送动作本身很快,整个订单的生命周期也短——从下单到送达往往控制在二十分钟以内。商家端的所有流程设计都必须围绕“快”来做。
第二,订单波峰极其集中。大学的上课作息决定了订单高峰出现在课间和午晚休时段,比如上午第二节课后的10:00到10:20,下午最后一节课后的17:00到17:30。短时间内的并发下单量是平时的好几倍,商家端的接单、拣货、派单操作如果设计得不够顺,高峰期就全卡在店员手上了。
第三,收货地址是“点”而不是“面”。商圈外卖的收货地址是小区楼栋门牌号,而校园外卖的收货点就是宿舍楼、教学楼、图书馆、行政楼这些固定点位。配送员对路线了如指掌,不需要导航,商家端在派单时只需要指定“送几号楼”就行。
第四,商品SKU结构和餐厅完全不同。超市里从饮料、零食到文具、日用品,SKU可能上千个,而外卖上架的商品往往是其中动销比较快的那一两百个。这就决定了商家端必须有一套轻量但完整的商品管理能力,分类、上下架、库存维护、价格批量调整,一个都不能少。
1.2 商家端的功能边界:哪些模块必须做进商家端
结合上面的场景,我把商家端拆成七个功能模块,第一版的核心范围是这样定的:
| 模块 | 核心功能 | 优先级 |
|---|---|---|
| 商家信息 | 店铺名称、营业时间、公告、配送范围设置 | 必做 |
| 商品管理 | 商品分类、上下架、价格维护、库存维护、批量导入 | 必做 |
| 订单接收 | 实时接收新订单、语音/弹窗提醒、订单筛选 | 必做 |
| 订单处理 | 接单、拒单、拣货完成、呼叫配送、异常处理 | 必做 |
| 配送调度 | 查看配送员、指派配送员、改派、配送状态跟踪 | 必做 |
| 数据统计 | 当日销售额、订单量、热销商品Top10 | 二期 |
| 营销工具 | 折扣、满减、限时秒杀 | 二期 |
第一版别贪多。很多人做这种系统上来就想把数据看板做得花里胡哨,结果核心的订单流转反而没有时间打磨。这个项目的核心命脉是“订单从产生到配送完成”的这条链路,其他都是辅助。
1.3 这个阶段最容易犯的错误:一上来就做全,结果什么都做不像
我见过不少同学做校园外卖系统,一上来就列了十几个数据表,商家端还要搞什么财务报表、用户画像,最后数据库建了二十多张表,前端页面写了没几张就烂尾了。
我的建议很直接:第一版就死磕订单闭环。商品能上架、库存能扣减、订单能进来、商家能接单、配送员能把货送到、状态能流转到底,这条链路通了,这个系统就已经成功了一大半。数据统计、营销工具这些都是锦上添花,后面随时可以补。
另外提醒一句,校园配送系统有一个非常关键但被很多人忽略的设定:配送费用怎么算?校园场景一般客单价低,如果每单收两三块配送费,学生用户大概率会流失。所以商家端通常要支持“满额免配送费”的配置,这笔配送成本实际上由商家或平台来承担。这个逻辑在普通外卖商家后台里一般不常涉及,但在校园系统里是刚需。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术选型与项目架构:我为什么选了Spring Boot + MyBatis Plus这套组合
2.1 后端框架选择的思考逻辑
做校园超市外卖配送系统,后端技术栈的选型要综合考虑开发效率、代码可维护性和部署成本。我最终选了 Spring Boot 2.7.x + Java 8 这对组合,没有上 Spring Cloud 微服务,也没有用 JPA,理由很实际。
先说不选微服务。高校超市外卖的并发量没到那个量级,高峰期撑死几百单并发,一个单体应用完全扛得住。微服务带来的服务拆分、注册中心、配置中心、链路追踪,对于这种规模的项目反而是负担。你还要额外部署Nacos、Gateway这些组件,光运维成本就能劝退大半人。单体架构配合合理分包,后期如果真要把用户端、商家端、配送员端拆成独立服务,代码层面也预留了模块边界,并不冲突。
再说不选JPA,选MyBatis Plus。Hibernate/JPA 在实体映射上确实省事,但在这个项目里,订单表、订单明细表、商品表之间的关联查询非常频繁,而且多表join、动态SQL、批量插入的场景很多,MyBatis Plus 写起来更可控,分页、条件构造器、逻辑删除这些常用功能也都有现成封装,开发效率并不低。国内用 MyBatis 的团队多,遇到问题社区资料也好找。
2.2 商家端的前后端分离方案
商家端我用的是 Vue3 + Element Plus 做管理后台页面。为什么选 Element Plus?因为它本身就是做后台管理系统出身的组件库,表格、表单、弹窗、树形控件都很成熟,做商品管理、订单列表这种典型后台页面效率极高。
另一个很关键的技术点,是商家端如何实时接收新订单。这里我用的是 WebSocket,而不是轮询。原因很简单:高峰期订单密集,轮询间隔短了会造成大量无效请求,间隔长了又延迟明显。WebSocket 可以在订单到达的瞬间把消息推到商家端页面,配合提示音和新订单弹窗,店员不需要一直盯着列表刷新。
简单放一下我后端 WebSocket 配置的思路:
java复制@Configuration
@EnableWebSocket
public class WebSocketConfig implements WebSocketConfigurer {
@Resource
private OrderWebSocketHandler orderWebSocketHandler;
@Override
public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {
registry.addHandler(orderWebSocketHandler, "/ws/merchant/{merchantId}")
.setAllowedOrigins("*");
}
}
每个商家连接时用 merchantId 作为路径参数,后端维护一个 merchantId 到 WebSocketSession 的映射,有新订单就推到这个商家自己的连接上。注意 setAllowedOrigins 的写法在新版本里建议改为 setAllowedOriginPatterns,不然跨域配置会有问题。
2.3 Redis 在商家端扮演的三个角色
Redis 在这个项目里不是可有可无的装饰品,它承担了三个很实在的任务。
第一个是库存预扣。超市商品是标品,库存有限,下单后立刻扣减库存可以有效防止超卖。但数据库的行锁在高峰期会成为性能瓶颈,所以我在下单时优先扣 Redis 里的库存,支付成功后再异步同步到 MySQL,这个后面第6章细讲。
第二个是热点数据缓存。商品列表、商品分类、店铺信息这些读多写少的数据,放进 Redis 之后能显著减轻数据库压力。
第三个是订单通知的轻量队列。下单时把订单ID push 到 Redis 的 List 结构里,商家端 WebSocket 服务从这个 List 中 pop 数据再推送给前端。中间隔了一层队列,就算商家端 WebSocket 连接闪断,订单数据也不会丢,重连之后再补推就行。
2.4 项目整体目录结构参考
后端我用的是标准的 Maven 多模块结构,按业务域分包,方便后期维护:
code复制supermarket-delivery/
├── delivery-common # 通用工具类、常量、枚举
├── delivery-admin-api # 商家端接口模块
├── delivery-user-api # 用户端接口模块
├── d
