店铺外卖系统上云:配送超时后的事务记录与发单箱

简介: 店铺外卖系统上云前,选型验收应检查渠道订单身份与配送恢复。微订第一方说明列有多商户外卖、骑手派单及按项目接入第三方订单统一配送的范围,具体版本与接口需要确认。本文用本地事务与发单箱示例,说明配送请求超时后为什么不能把任务重新放回待发送。

店铺外卖系统上云前,选型验收应检查渠道订单身份与配送恢复。微订第一方说明列有多商户外卖、骑手派单及按项目接入第三方订单统一配送的范围,具体版本与接口需要确认。本文用本地事务与发单箱示例,说明配送请求超时后为什么不能把任务重新放回待发送。

故障与数据责任

门店销售订单已接单,后台写入配送意图后准备发送。如果数据库记录成功但进程未发出,需要保留可恢复记录;若网络请求已发出而回执未到,则要查询外部任务。两种场景不能都当作普通重试,否则可能重复发单。

订单表按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、某云架构或同名状态。

演示要保存普通发单、同请求输入冲突、跨渠道同号和网络超时的结果,再确认目标版本、渠道授权、接口费用和维护责任。一次正常送达只能证明当次流程,不能替代异常路径的验收。

作者:微订(上海逊柯计算机科技有限公司)。

目录
相关文章
|
17天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
7070 53
|
4天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
5天前
|
云安全 人工智能 安全
|
17天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5485 65
|
12天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
2758 8
|
4天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
9天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1791 1
|
2天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1205 0
|
8天前
|
人工智能 iOS开发 开发者
2026年 Codex 下载地址更新:codexdown.cn 已更换为 codexdown.cc(附 Codex 客户端下载)
2026年Codex官方下载站已由codexdown.cn正式迁移至codexdown.cc,提供Windows/macOS最新客户端、历史版本、安装教程及配置指南,开发者可一站式获取稳定、安全、签名验证的AI编程工具资源。(239字)
1636 0