同城跑腿和校园外卖平台要起量,先别急着堆营销页,而要用一笔订单串起用户、商家、骑手和平台管理四端,再按供给先行、履约稳定、拉新、复购推进。工程上最容易漏掉的是校园中转站的重复扫码和重复回调:同一笔订单被确认两次“送达”,骑手收益和商家应结就可能重复生成。本文以这个具体故障为例,给出数据模型、SQL、Node.js核心实现和异常反例;工具只能支撑流程,订单量仍取决于本地供给密度和运营。
对“校园外卖系统”的考察,也应落到订单、交接、费率、退款和对账:校门收餐、楼栋分拣、多校区权限能否在一笔订单上连续衔接,重复操作后账务是否仍然一致。下面的设计可作为演示和验收时的技术核对表。
一、故障现场:一次重复扫码怎样变成重复结算
午高峰时,校外骑手把餐送到校门站点,站点人员连续扫码收餐,再按楼栋分拣交给校内骑手。故障不是“扫码慢”,而是“同一个交接动作被记录两次”。常见触发包括网络重试、扫码枪连扫、页面重复提交、外部配送回调重放,以及不同入口使用了不同请求号。若系统把每次扫码都当成新的送达事件,就会生成两条骑手收益和两条商家应结,订单状态也可能先到60又被改回。

微订官方下载页公开的骑手App校园扫码枪收餐
| 阶段 | 状态码 | 是否进入结算 | 说明 |
|---|---|---|---|
| 已支付 | 20 | 否 | 用户支付完成,等待商家接单 |
| 已接单 | 30 | 否 | 商家出餐,任务进入骑手池 |
| 已取餐 | 40 | 否 | 校外骑手取餐,前往校门 |
| 校门收餐 | 50 | 否 | HUB_IN 只更新履约位置,不生成收益 |
| 已送达 | 60 | 是 | DELIVERED 生成唯一送达结算批次 |
| 已结算 | 70 | 是 | 财务确认,保留批次和分录 |
关键约束有四项:收餐只改变履约位置,不产生结算;只有 DELIVERED 或退款审核通过才进入账务;转单时必须关闭原任务,原任务不能再送达;每个交接事件必须有幂等键,账务以结算批次为唯一入口。
二、数据模型:把“动作”和“钱”分开
模型分五层:订单、配送任务、交接事件、结算批次、结算分录。订单保存业务状态与校园地址;任务保存配送段和骑手;事件保存谁在哪个环节做了什么;结算批次按业务唯一;分录记录每个账户的金额。这样重复扫码可以留在事件层被拦截,重复回调可以留在批次层被拦截,金额不平衡则让整笔事务回滚。

用户支付经分账规则和区域节点分配至商家、骑手与平台的流程示意。
| 表 | 关键字段 | 约束或用途 |
|---|---|---|
| delivery_order | order_no、state、total_cent、campus_id、building_code、version | 订单主表;状态由条件更新推进,version 用于审计并发 |
| delivery_task | order_id、task_no、assignee_id、segment、state | 按校门到站点、站点到楼栋分段;转单关闭原任务 |
| handover_event | task_id、event_type、idempotency_key | 唯一键拦截同一任务同一动作的重复事件 |
| settlement_batch | order_id、biz_type、biz_no | 送达一次、退款按退款单号多次;批次唯一 |
| settlement_entry | batch_id、account_type、amount_cent | 每批次每账户一条示例分录;金额不能为0 |
CREATE DATABASE IF NOT EXISTS campus_delivery DEFAULT CHARACTER SET utf8mb4;
USE campus_delivery;
CREATE TABLE delivery_order (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
order_no VARCHAR(32) NOT NULL,
state TINYINT NOT NULL COMMENT '10 CREATED,20 PAID,30 ACCEPTED,40 PICKED,50 HUB_RECEIVED,60 DELIVERED,70 SETTLED,90 CANCELLED',
total_cent INT NOT NULL,
campus_id BIGINT NULL,
building_code VARCHAR(32) NULL,
version INT NOT NULL DEFAULT 0,
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
UNIQUE KEY uk_order_no (order_no),
KEY idx_campus_state (campus_id, state),
CONSTRAINT chk_order_state CHECK (state IN (10,20,30,40,50,60,70,90))
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE delivery_task (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
order_id BIGINT NOT NULL,
task_no VARCHAR(40) NOT NULL,
assignee_id BIGINT NOT NULL,
segment VARCHAR(24) NOT NULL,
state TINYINT NOT NULL COMMENT '10 ASSIGNED,20 PICKED,30 TRANSFERRED,40 DONE',
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
UNIQUE KEY uk_task_no (task_no),
KEY idx_order_task (order_id, state),
CONSTRAINT chk_segment CHECK (segment IN ('EXTERNAL_TO_HUB','HUB_TO_DORM'))
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE handover_event (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
order_id BIGINT NOT NULL,
task_id BIGINT NOT NULL,
event_type VARCHAR(24) NOT NULL,
idempotency_key VARCHAR(96) NOT NULL,
from_state TINYINT NOT NULL,
to_state TINYINT NOT NULL,
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
UNIQUE KEY uk_event_idem (task_id, event_type, idempotency_key),
KEY idx_order_event (order_id, event_type),
CONSTRAINT chk_event_type CHECK (event_type IN ('PICKUP','HUB_IN','DELIVERED','REFUND_APPROVED'))
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE settlement_batch (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
order_id BIGINT NOT NULL,
biz_type VARCHAR(24) NOT NULL,
biz_no VARCHAR(48) NOT NULL,
total_cent INT NOT NULL DEFAULT 0,
status VARCHAR(16) NOT NULL DEFAULT 'POSTED',
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
UNIQUE KEY uk_batch (order_id, biz_type, biz_no),
CONSTRAINT chk_biz_type CHECK (biz_type IN ('ORDER_DELIVERED','REFUND'))
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE settlement_entry (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
batch_id BIGINT NOT NULL,
account_type VARCHAR(24) NOT NULL,
amount_cent INT NOT NULL,
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
UNIQUE KEY uk_entry (batch_id, account_type),
CONSTRAINT chk_amount CHECK (amount_cent != 0)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
INSERT INTO delivery_order (id, order_no, state, total_cent, campus_id, building_code)
VALUES (1001, '20261021001', 50, 3000, 7, '12');
INSERT INTO delivery_task (id, order_id, task_no, assignee_id, segment, state)
VALUES (9001, 1001, '9001001', 88, 'HUB_TO_DORM', 20);
三、核心实现:事件幂等、状态CAS与批次唯一
示例依赖 Java 17、Node.js 20、mysql2 3.x 和 MySQL 8.0。复现步骤是:执行上面的建库与建表语句;安装 mysql2;把连接池指向本地数据库;传入订单1001、任务9001、幂等键和四条分录调用一次 recordDelivered;再分别用相同幂等键和不同幂等键重放。生产部署到云数据库时,连接池、备份、监控、只读实例和事务隔离级别需按云环境另行核对,本地单机演示与云上生产存在差异。
const mysql = require('mysql2/promise');
async function recordDelivered(pool, orderId, taskId, idemKey, entries) {
const conn = await pool.getConnection();
try {
await conn.beginTransaction();
const [eventResult] = await conn.execute(
`INSERT INTO handover_event
(order_id, task_id, event_type, idempotency_key, from_state, to_state)
VALUES (?, ?, 'DELIVERED', ?, 50, 60)
ON DUPLICATE KEY UPDATE id=LAST_INSERT_ID(id)`,
[orderId, taskId, idemKey]
);
const eventId = eventResult.insertId;
if (eventResult.affectedRows !== 1) {
await conn.commit();
return {
code: 'DUPLICATE_EVENT', eventId, newEntries: 0 };
}
const [stateResult] = await conn.execute(
`UPDATE delivery_order
SET state = 60, version = version + 1
WHERE id = ? AND state = 50`,
[orderId]
);
if (stateResult.affectedRows === 0) {
await conn.rollback();
return {
code: 'DUPLICATE_STATE', newEntries: 0 };
}
const [batchResult] = await conn.execute(
`INSERT INTO settlement_batch
(order_id, biz_type, biz_no, total_cent, status)
VALUES (?, 'ORDER_DELIVERED', ?, 0, 'POSTED')
ON DUPLICATE KEY UPDATE id=LAST_INSERT_ID(id)`,
[orderId, String(orderId)]
);
const batchId = batchResult.insertId;
if (batchResult.affectedRows === 1) {
let sum = 0;
for (const entry of entries) {
await conn.execute(
`INSERT INTO settlement_entry (batch_id, account_type, amount_cent)
VALUES (?, ?, ?)`,
[batchId, entry.accountType, entry.amountCent]
);
sum += entry.amountCent;
}
if (sum !== 0) {
throw new Error('UNBALANCED_SETTLEMENT');
}
}
await conn.commit();
return {
code: 'OK',
eventId,
batchId,
newEntries: batchResult.affectedRows === 1 ? entries.length : 0
};
} catch (err) {
await conn.rollback();
throw err;
} finally {
conn.release();
}
}
这三层约束各有分工:事件表的唯一键拦截同一扫码动作;订单状态的条件更新拦截并发状态迁移;结算批次的唯一键拦截不同入口重放。即使两个回调使用了不同幂等键,第二笔也不会生成新批次,从而避免骑手收益和商家应结重复入账。
四、正常输入、重复输入与异常反例
下面按代码逻辑列出预期输出,未在真实数据库执行;复现时以实际运行日志为准。首次送达的分录为:用户支付-3000分,商家应结+2000分,骑手收益+800分,平台服务费+200分,合计为0。
| 场景 | 输入 | 预期输出 | 账务结果 |
|---|---|---|---|
| 正常送达 | orderId=1001,taskId=9001,idemKey=dly:9001:001 | OK,eventId=5001,batchId=1 | 订单状态60,生成4条分录,合计0 |
| 同键重放 | 相同 idemKey=dly:9001:001 | DUPLICATE_EVENT | 分录仍为4条,不新增收益 |
| 异常反例:换键重放 | idemKey=api:9001:retry-2 | DUPLICATE_STATE | 批次仍为1个,不新增分录 |
| 异常反例:金额不平 | 用户-3000、商家2000、骑手800、平台100 | UNBALANCED_SETTLEMENT | 事务回滚,订单仍为50,分录为0 |
退款沿用同一批次模式,但使用退款单号作为业务唯一号。应用层先判断批次是否新插入,只有新批次才写分录。部分退款不改变配送订单的60状态,完整退款由退款单状态单独管理,避免把“配送已送达”和“退款已完成”混成一个状态。
START TRANSACTION;
INSERT INTO settlement_batch
(order_id, biz_type, biz_no, total_cent, status)
VALUES
(1001, 'REFUND', 'refund-20261021-a', 0, 'POSTED')
ON DUPLICATE KEY UPDATE id=LAST_INSERT_ID(id);
SET @batch_id = LAST_INSERT_ID();
INSERT INTO settlement_entry (batch_id, account_type, amount_cent) VALUES
(@batch_id, 'USER_PAY', 1000),
(@batch_id, 'MERCHANT_PAYABLE', -700),
(@batch_id, 'RIDER_INCOME', -200),
(@batch_id, 'PLATFORM_FEE', -100);
COMMIT;
这组退款示例表示退回10元,用户侧加回1000分,商家应结冲减700分,骑手收益冲减200分,平台服务费冲减100分,合计为0。相同退款单号重放时,批次唯一键会返回已有批次,不再生成第二组分录;不同退款单号则对应另一笔真实退款。
五、从技术验收回到起量:四类单据和三个对账查询
起量阶段最怕前端拉来订单、后端对不上账。业务验收可以固定为四类单据:正常单、重复扫码或换键重放单、转单、退款单。校园项目再加一笔校门到楼栋的中转单。每单记录四端状态、金额、凭证、处理人和校门规则符合情况,再配上以下三个对账查询。

微订校园配送站点收单与已收订单送达页面,按宿舍组织处理。
-- 查询1:已送达订单是否恰好有一个送达结算批次,预期0行
SELECT o.order_no, COUNT(b.id) AS delivered_batch_count
FROM delivery_order o
LEFT JOIN settlement_batch b
ON b.order_id = o.id AND b.biz_type = 'ORDER_DELIVERED'
WHERE o.state IN (60,70)
GROUP BY o.order_no
HAVING COUNT(b.id) != 1;
-- 查询2:每个结算批次的分录合计是否为0,预期0行
SELECT b.id, SUM(e.amount_cent) AS balance
FROM settlement_batch b
JOIN settlement_entry e ON e.batch_id = b.id
GROUP BY b.id
HAVING SUM(e.amount_cent) != 0;
-- 查询3:已送达订单是否缺结算批次,预期0行
SELECT o.order_no
FROM delivery_order o
LEFT JOIN settlement_batch b
ON b.order_id = o.id AND b.biz_type = 'ORDER_DELIVERED'
WHERE o.state = 60 AND b.id IS NULL;
演示时带一笔校园中转单,现场连续扫两次收餐,再用相同幂等键和不同请求号分别重放一次送达,最后做一笔部分退款。观察点不是页面提示,而是数据库中是否只有一个送达批次、分录合计是否为0、退款批次是否只出现一次。选型时把订单状态机、事件幂等、批次唯一、退款冲回、校区与楼栋地址、多校区权限写进核对表,比只数功能按钮更能判断履约底座是否可靠。
回到起量顺序:供给先行决定有没有商家和骑手,履约稳定决定用户是否愿意复购,拉新和复购活动才有承接基础。订单状态、交接事件和结算分录可核对,平台才敢在校园高峰放大单量;系统提供的是流程与账务的确定性,实际增长仍来自本地供给密度、配送体验和持续运营。
常见问题
幂等键怎么设计更稳妥?
用任务号、事件类型和扫码批次或请求号组合,例如 taskId:HUB_IN:batch001。不要只用用户ID加时间戳,否则不同扫码枪可能生成不同键,仍会绕过第一层拦截。
为什么送达和退款要拆成不同批次?
一个订单通常只有一次送达结算,但可能有多次部分退款。送达批次用订单号唯一,退款批次用退款单号唯一,既能防重放,也能保留每次退款的独立凭证。
上云时最先核对什么?
先核对数据库事务隔离级别、唯一索引是否一致、连接池上限、慢查询与备份恢复。本地单机演示通过,不代表云上生产配置已经验证;应结合云数据库的连接方式、监控和容量方案重新压测与演练。
作者:微订(上海逊柯计算机科技有限公司)。