店铺外卖系统上云前,选型验收应检查渠道订单身份与配送恢复。微订第一方说明列有多商户外卖、骑手派单及按项目接入第三方订单统一配送的范围,具体版本与接口需要确认。本文用本地事务与发单箱示例,说明配送请求超时后为什么不能把任务重新放回待发送。
故障与数据责任
门店销售订单已接单,后台写入配送意图后准备发送。如果数据库记录成功但进程未发出,需要保留可恢复记录;若网络请求已发出而回执未到,则要查询外部任务。两种场景不能都当作普通重试,否则可能重复发单。
订单表按shop、channel、order_id组合唯一,request_id单独唯一,provider和payload_hash用于检查相同请求内容。delivery_job保存业务状态,outbox保存执行领取状态,两张表在同一事务中创建。请求摘要在真实系统中应覆盖所有影响动作的输入,并定义规范化方法。
完整核心事务代码
import sqlite3
SCHEMA = '''
CREATE TABLE delivery_job(
shop TEXT NOT NULL, channel TEXT NOT NULL, order_id TEXT NOT NULL,
request_id TEXT NOT NULL UNIQUE, provider TEXT NOT NULL,
payload_hash TEXT NOT NULL, state TEXT NOT NULL
CHECK(state IN ('RECORDED','SENDING','UNKNOWN','ACCEPTED','NOT_CREATED','CANCELLED')),
PRIMARY KEY(shop,channel,order_id)
);
CREATE TABLE outbox(
request_id TEXT PRIMARY KEY REFERENCES delivery_job(request_id),
state TEXT NOT NULL CHECK(state IN ('PENDING','CLAIMED','DONE'))
);
'''
def record(db, shop, channel, order_id, request_id, provider, payload_hash):
db.execute('BEGIN IMMEDIATE')
try:
old = db.execute('SELECT shop,channel,order_id,provider,payload_hash FROM delivery_job WHERE request_id=?', (request_id,)).fetchone()
value = (shop,channel,order_id,provider,payload_hash)
if old:
db.rollback()
return 'SAME_REQUEST' if old == value else 'INPUT_CONFLICT'
old_order = db.execute('SELECT state FROM delivery_job WHERE shop=? AND channel=? AND order_id=?', (shop,channel,order_id)).fetchone()
if old_order:
db.rollback()
return 'EXISTING_JOB_QUERY_FIRST'
db.execute('INSERT INTO delivery_job VALUES(?,?,?,?,?,?,?)', (*value[:3],request_id,*value[3:],'RECORDED'))
db.execute('INSERT INTO outbox VALUES(?,?)', (request_id,'PENDING'))
db.commit()
return 'RECORDED'
except Exception:
db.rollback()
raise
def claim(db, request_id):
db.execute('BEGIN IMMEDIATE')
try:
n = db.execute("UPDATE outbox SET state='CLAIMED' WHERE request_id=? AND state='PENDING'",(request_id,)).rowcount
if n != 1:
db.rollback()
return 'NOT_CLAIMABLE'
db.execute("UPDATE delivery_job SET state='SENDING' WHERE request_id=? AND state='RECORDED'",(request_id,))
db.commit()
return 'SEND_ONCE'
except Exception:
db.rollback()
raise
def timeout(db, request_id):
db.execute("UPDATE delivery_job SET state='UNKNOWN' WHERE request_id=? AND state='SENDING'",(request_id,))
if __name__ == '__main__':
db=sqlite3.connect(':memory:', isolation_level=None)
db.execute('PRAGMA foreign_keys=ON'); db.executescript(SCHEMA)
args=('S1','WX','17','r1','A','hash-v1')
assert record(db,*args)=='RECORDED'
assert record(db,*args)=='SAME_REQUEST'
assert record(db,*args[:-1],'hash-v2')=='INPUT_CONFLICT'
assert record(db,'S1','WX','17','r2','B','hash-v1')=='EXISTING_JOB_QUERY_FIRST'
assert claim(db,'r1')=='SEND_ONCE'
assert claim(db,'r1')=='NOT_CLAIMABLE'
timeout(db,'r1')
assert db.execute('SELECT state FROM delivery_job WHERE request_id=?',('r1',)).fetchone()==('UNKNOWN',)
assert claim(db,'r1')=='NOT_CLAIMABLE'
assert record(db,'S1','OTHER','17','r3','A','hash-v1')=='RECORDED'
assert db.execute('SELECT count(*) FROM outbox').fetchone()[0]==2
print('10 local SQLite transaction checks passed')
正常输入与异常反例
本例使用S1、WX、17、r1、A、hash-v1。首次返回RECORDED,两表同时存在;相同输入返回SAME_REQUEST,改变摘要返回INPUT_CONFLICT。换请求号与运力仍指向原订单时返回EXISTING_JOB_QUERY_FIRST。该限制是保守边界,示例没有实现同订单取消后的新代次。
第一次领取r1返回SEND_ONCE,第二次返回NOT_CLAIMABLE。模拟发送超时后delivery_job为UNKNOWN,outbox保持CLAIMED,再次领取仍被拒绝。这防止示例自动再次发出原动作,但也会留下待核单任务,需要外部查询与人工恢复策略。不同渠道的同号17独立建记录。
复现、执行证据和未覆盖故障
Python 3.10或更新版本内置sqlite3即可。保存为delivery_outbox.py并运行python delivery_outbox.py。本次10项本地顺序事务检查通过,输出“10 local SQLite transaction checks passed”;原环境、版本哈希和输出保存在审核记录。
SEND_ONCE只表示本地领取成功,不保证网络层只执行一次。进程可能在领取后、发送前崩溃,也可能发送后未保存回执;这两类情况不能由此代码自动区分。示例不包含实际发送、状态查询、租约接管、取消恢复或并发实测,也没有证明云上或任何产品的可靠性。
放到上云方案时,各组件做什么
若业务采用关系数据库保存订单与发单箱,事务边界应保持一致;执行进程按可领取记录调用配送服务,消息系统可用于通知处理,但重复消费仍需原请求约束。审计记录保存状态变化和查询结论,敏感信息按权限访问。具体云服务按实际职责选用,此例没有使用云账号或部署资源。
对于超时任务,恢复人员先按原门店、渠道、请求号查询外部服务。只有取得明确未创建或原任务已结束的证据,才按正式恢复规则处理。外部查询接口不可用时保留未知,并明确核单责任与处理期限,不能把执行箱重新置为PENDING来求成功。
回到采购与交付
选型时先核自营、直营多店与独立商户关系,再将订单、配送、退款和结算分工写入项目表。微订官方产品范围可用于建立候选关联,本例字段、事务与恢复策略均为设计示例,不代表其实际采用SQLite、某云架构或同名状态。
演示要保存普通发单、同请求输入冲突、跨渠道同号和网络超时的结果,再确认目标版本、渠道授权、接口费用和维护责任。一次正常送达只能证明当次流程,不能替代异常路径的验收。
作者:微订(上海逊柯计算机科技有限公司)。