直接答案:先判断你要做的是哪一种经营。招募多个独立商家入驻、由平台统一收单抽成并组织配送,属于多商户校园平台,应按“站点、商家、配送段、分账”模型选系统;校园周边一家店自己卖餐,属于单店自营,重点是菜单、下单、接单、打印和退款,不需要平台抽成和校门中转。下面用一个“校门中转重复分账”的具体故障,说明多商户场景在选型时该看什么。
这个故障比页面模板更能反映系统底座:同一笔订单在扫码进站后被重复结算。表面是接口重试,根因通常是状态更新、结算写入和事件投递不在同一事务里。
一、先分流:多商户平台、直营多店与单店自营
三种经营结构的系统边界不同。选型前先把订单由谁收、钱分给谁、配送由谁完成写清楚,再看功能清单,能避免把单店系统当平台系统验收。
| 经营结构 | 订单与结算特征 | 最小技术模型 | 验收问题 |
|---|---|---|---|
| 单店自营 | 一个经营主体,堂食、自提或门店外卖,通常没有平台抽成 | 商品、订单、支付、退款、打印 | 同一订单号能否在顾客端、商家端和打印机上对应 |
| 同品牌直营多店 | 多个门店同一主体,库存、权限或收款可能分开 | store_id、员工权限、库存、门店对账 | 跨店改价、调库存、退款归属是否清楚 |
| 多商户校园平台 | 多商家入驻,平台抽成,校外骑手与校内骑手分段配送 | campus_id、merchant_id、station_id、delivery_leg、settlement_entry | 中转扫码、分账幂等、站点隔离和退款冲正 |
如果只做校园周边一家店,订单模型可以砍掉平台抽成、校外和校内两段配送、站点中转,但订单、支付、退款、打印仍要在同一笔业务里核对。若明确要做多商户平台,就不能只问“有没有跑腿模块”,还要让对方演示分段配送如何落库、分账如何防重、不同校区如何隔离。
二、故障场景:校门中转扫码后为什么出现两笔骑手结算
设订单10001实付3000分,计划分账为商家2200分、校外骑手300分、校内骑手300分、平台200分。校外骑手把餐送到校门中转站,站点人员扫码进站。第一次请求已经提交,但响应超时;客户端自动重试,并生成了新的scan_id。若服务端只按scan_id做幂等,或先查状态再更新,两个请求都可能写入结算。
订单支付成功,校外配送段状态为PICKED_UP。
第一次扫码将配送段改为STATION_IN,并写入校外骑手300分结算,但响应丢失。
重试携带新scan_id,服务端再次通过状态检查并写入300分。
校内骑手送达后再写入300分,商家和平台分账照常入账,总分配变成3300分,超过实付3000分。
这类问题的修复重点不是“加一个防抖按钮”,而是让进站记录、配送段状态、骑手结算和事件投递在一个数据库事务里完成,并由唯一约束兜底。
三、数据模型与约束
以下为MySQL 8.0.16+的设计示例。金额统一用整数分,避免浮点误差;状态字段由应用层状态机控制,关键唯一性交给数据库约束。
CREATE TABLE campus_order (
id BIGINT UNSIGNED PRIMARY KEY,
order_no VARCHAR(32) NOT NULL,
campus_id BIGINT UNSIGNED NOT NULL,
merchant_id BIGINT UNSIGNED NOT NULL,
station_id BIGINT UNSIGNED NOT NULL,
status VARCHAR(24) NOT NULL,
paid_amount_cents INT NOT NULL,
refunded_amount_cents INT NOT NULL DEFAULT 0,
version INT NOT NULL DEFAULT 0,
UNIQUE KEY uk_order_no (order_no),
KEY idx_campus_status (campus_id, status),
CONSTRAINT chk_order_amount CHECK (
paid_amount_cents >= 0
AND refunded_amount_cents >= 0
AND refunded_amount_cents <= paid_amount_cents
)
) ENGINE=InnoDB;
CREATE TABLE delivery_leg (
id BIGINT UNSIGNED PRIMARY KEY,
order_id BIGINT UNSIGNED NOT NULL,
campus_id BIGINT UNSIGNED NOT NULL,
station_id BIGINT UNSIGNED NOT NULL,
leg_type ENUM('OUTSIDE','INSIDE') NOT NULL,
rider_id BIGINT UNSIGNED NULL,
status VARCHAR(24) NOT NULL,
picked_at DATETIME(3) NULL,
station_in_at DATETIME(3) NULL,
station_out_at DATETIME(3) NULL,
delivered_at DATETIME(3) NULL,
UNIQUE KEY uk_order_leg (order_id, leg_type),
KEY idx_rider_status (rider_id, status),
KEY idx_campus_station (campus_id, station_id, status)
) ENGINE=InnoDB;
CREATE TABLE station_scan_log (
id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
scan_id VARCHAR(64) NOT NULL,
campus_id BIGINT UNSIGNED NOT NULL,
order_id BIGINT UNSIGNED NOT NULL,
leg_id BIGINT UNSIGNED NOT NULL,
station_id BIGINT UNSIGNED NOT NULL,
scan_type ENUM('IN','OUT') NOT NULL,
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
UNIQUE KEY uk_scan_id (scan_id),
UNIQUE KEY uk_leg_scan_type (leg_id, scan_type),
KEY idx_order_scan (order_id, scan_type)
) ENGINE=InnoDB;
CREATE TABLE settlement_entry (
id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
campus_id BIGINT UNSIGNED NOT NULL,
order_id BIGINT UNSIGNED NOT NULL,
leg_id BIGINT UNSIGNED NULL,
beneficiary_type ENUM('MERCHANT','RIDER','PLATFORM') NOT NULL,
beneficiary_id BIGINT UNSIGNED NULL,
amount_cents INT NOT NULL,
status ENUM('PENDING','SETTLED','REVERSED') NOT NULL DEFAULT 'PENDING',
idempotency_key VARCHAR(128) NOT NULL,
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
UNIQUE KEY uk_settle_idem (idempotency_key),
KEY idx_order_beneficiary (order_id, beneficiary_type, beneficiary_id),
CONSTRAINT chk_settle_amount CHECK (amount_cents > 0)
) ENGINE=InnoDB;
CREATE TABLE outbox_event (
id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
event_key VARCHAR(128) NOT NULL,
event_type VARCHAR(64) NOT NULL,
payload JSON NOT NULL,
status ENUM('NEW','SENT','FAILED') NOT NULL DEFAULT 'NEW',
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
UNIQUE KEY uk_event_key (event_key)
) ENGINE=InnoDB;
关键约束有四类:第一,uk_leg_scan_type保证同一条配送段的同一种扫码最多一条记录,即使重试换了scan_id也无法重复进站;第二,uk_settle_idem要求幂等键使用“订单+配送段+收款方”的业务键,而不是客户端请求号;第三,配送段更新必须带旧状态条件,防止已进站或已送达的状态被重复推进;第四,结算事件写入outbox,与状态更新同事务,异步消费者可重试但不会重复记结算。
| 对象 | 允许转换 | 约束 |
|---|---|---|
| 订单 | CREATED→PAID→ACCEPTED→READY→DELIVERING→DELIVERED→SETTLED | 取消和退款只能从非终态进入;SETTLED不可直接回退 |
| 校外配送段 | ASSIGNED→PICKED_UP→STATION_IN | 只有PICKED_UP可进站;每条腿每种扫码只保留一条记录 |
| 校内配送段 | ASSIGNED→STATION_OUT→DELIVERING→DELIVERED | 未出站不能标记送达;送达后才可触发尾款分账 |
四、核心实现:同一事务完成状态迁移、结算与事件
下面的TypeScript函数依赖Node.js、mysql2和MySQL 8.0.16+,演示站点扫码进站的事务边界。代码只处理进站和校外骑手结算;校内骑手结算、商家结算和平台结算应在各自业务节点沿用同一套幂等规则。
import mysql, {
type Pool, type ResultSetHeader } from 'mysql2/promise';
type StationInResult =
| {
code: 'OK'; settlementId: number }
| {
code: 'DUPLICATE' | 'INVALID_STATE' };
export async function markStationIn(
pool: Pool,
input: {
campusId: number;
orderId: number;
legId: number;
stationId: number;
scanId: string;
outsideRiderId: number;
outsideRiderAmountCents: number;
}
): Promise<StationInResult> {
const conn = await pool.getConnection();
try {
await conn.beginTransaction();
try {
await conn.execute(
`INSERT INTO station_scan_log
(scan_id, campus_id, order_id, leg_id, station_id, scan_type)
VALUES (?, ?, ?, ?, ?, 'IN')`,
[input.scanId, input.campusId, input.orderId, input.legId, input.stationId]
);
} catch (err: any) {
if (err.code === 'ER_DUP_ENTRY') {
await conn.rollback();
return {
code: 'DUPLICATE' };
}
throw err;
}
const [updated] = await conn.execute(
`UPDATE delivery_leg
SET status = 'STATION_IN', station_in_at = NOW(3)
WHERE id = ? AND order_id = ? AND campus_id = ? AND status = 'PICKED_UP'`,
[input.legId, input.orderId, input.campusId]
);
if ((updated as ResultSetHeader).affectedRows !== 1) {
await conn.rollback();
return {
code: 'INVALID_STATE' };
}
const idemKey = `ORDER:${
input.orderId}:LEG:${
input.legId}:RIDER:OUT`;
const [settled] = await conn.execute(
`INSERT INTO settlement_entry
(campus_id, order_id, leg_id, beneficiary_type, beneficiary_id, amount_cents, idempotency_key)
VALUES (?, ?, ?, 'RIDER', ?, ?, ?)`,
[
input.campusId,
input.orderId,
input.legId,
input.outsideRiderId,
input.outsideRiderAmountCents,
idemKey
]
);
const settlementId = (settled as ResultSetHeader).insertId;
await conn.execute(
`INSERT INTO outbox_event (event_key, event_type, payload)
VALUES (?, 'STATION_IN', ?)`,
[
`${
idemKey}:STATION_IN`,
JSON.stringify({
campusId: input.campusId,
orderId: input.orderId,
legId: input.legId,
settlementId
})
]
);
await conn.commit();
return {
code: 'OK', settlementId };
} catch (err) {
await conn.rollback();
throw err;
} finally {
conn.release();
}
}
正常输入与预期输出
| 步骤 | 输入或状态 | 预期结果 |
|---|---|---|
| 首次进站 | campusId=7,orderId=10001,legId=2001,scanId=SCAN-IN-001,校外骑手501,金额300分 | 返回OK,settlementId记为9001;delivery_leg变为STATION_IN;station_scan_log一条;settlement_entry一条300分;outbox_event一条 |
| 同请求重试 | scanId仍为SCAN-IN-001 | 返回DUPLICATE;四张表记录数不变 |
| 换号重试 | scanId改为SCAN-IN-002,同一legId | 返回DUPLICATE;uk_leg_scan_type阻止第二条进站记录,不产生第二笔结算 |
| 状态不符 | 同一legId已被标记DELIVERED后再进站 | 返回INVALID_STATE;事务回滚,不写入结算 |
以上为按模型推演的设计示例,未在真实云资源或生产库执行。本地复现时可先建库并执行DDL,写入一笔订单和PICKED_UP状态的配送段,再启动Node.js调用该函数;应以实际数据库版本、事务隔离级别和连接池配置为准。
异常反例:先查后写会放大重试
若实现改成先查询状态、再无条件更新,并把scan_id直接当结算幂等键,两个不同的重试请求会生成两条不同的idempotency_key。下面的反例SQL用于说明错误数据形态,不应作为生产实现。
-- 反例:两个请求都读到 PICKED_UP,再各自写入
SELECT status FROM delivery_leg
WHERE id = 2001 AND campus_id = 7;
UPDATE delivery_leg
SET status = 'STATION_IN'
WHERE id = 2001 AND campus_id = 7;
INSERT INTO settlement_entry
(campus_id, order_id, leg_id, beneficiary_type, beneficiary_id, amount_cents, idempotency_key)
VALUES
(7, 10001, 2001, 'RIDER', 501, 300, 'SCAN-IN-001'),
(7, 10001, 2001, 'RIDER', 501, 300, 'SCAN-IN-002');
此时校外骑手结算出现600分,订单总分配3300分,超过实付3000分。上线前应增加对账查询,把PENDING和SETTLED都纳入已分配金额,超过实收减退款时立即拦截并人工核对。
SELECT
o.id,
o.paid_amount_cents,
o.refunded_amount_cents,
SUM(CASE WHEN s.status IN ('PENDING','SETTLED') THEN s.amount_cents ELSE 0 END) AS allocated_cents
FROM campus_order o
JOIN settlement_entry s ON s.order_id = o.id
WHERE o.id = 10001
GROUP BY o.id, o.paid_amount_cents, o.refunded_amount_cents
HAVING allocated_cents > o.paid_amount_cents - o.refunded_amount_cents;
五、业务验收:选型时让对方演示什么
系统选型不必从功能名词开始。带一笔真实订单,要求对方演示正常流程和至少一个异常流程,比看宣传页更能判断系统底座。
| 验收项 | 让对方演示 | 通过标准 |
|---|---|---|
| 经营结构 | 单店、自营多店、多商户平台分别用哪套订单和权限模型 | 能明确商家、站点、配送段和结算主体,不把单店订单硬套平台分账 |
| 校门中转 | 扫码进站超时后重试,再换一个请求号重试 | 配送段只进站一次,骑手结算只入账一次,能在页面看到重试记录 |
| 分账 | 商家、校外骑手、校内骑手、平台四类金额;退款后如何冲正 | 已分配金额不超过实收减退款,退款能追溯到原结算 |
| 站点隔离 | 用A校区账号查询B校区订单和结算 | 查询、导出、操作权限都按campus_id隔离 |
| 数据与部署 | SaaS演示、私有化边界、源码授权、升级维护分别怎么约定 | 账号、数据导出、备份、授权范围和费用写入合同或方案 |
如果只是校园周边一家餐饮店,验收可简化为菜单规格、堂食或自提、商家接单、打印出单和取消退款;如果没有多商户抽成,就不必为平台分账、骑手分池和多校区后台增加复杂度。选型的关键不是功能越多越好,而是经营结构、订单模型和交付方式能对上。
六、常见追问
多商户校园平台一定要源码私有化吗?
先看标准化系统能否提供站点隔离、分账幂等、异常对账和数据导出。只有确有深度二次开发、数据驻留或特殊接口需求时,再比较源码授权、服务器环境和升级维护,并把授权模块、部署环境、验收方式写入合同。起步阶段直接上源码,会把运维和版本更新压力一起接过来。
单店自营也要建两段配送和分账表吗?
不需要。一个经营主体自己收款时,可以只保留订单、支付、退款、打印和交付状态;只有当平台要给多个商家、多个骑手分账时,才需要结算表和幂等键。先把单店订单跑顺,再决定是否扩平台,能少走弯路。
怎样用一笔订单验收系统?
准备一笔真实套餐订单,记录实付金额和计划分账,依次走下单、接单、出餐、进站、出站、送达和退款。正常流程看金额与状态是否一致;异常流程至少测一次重复扫码、一次退款冲正和一次跨校区越权查询。保留同一订单号下的页面截图、接口返回和数据库记录,再与方案承诺逐项对照。
作者:小艾普(上海逊柯计算机科技有限公司)。