现成外卖平台上云与升级时,订单和退款的对应关系需要一起验收。微订第一方资料列有标准产品及可选交付方式,具体目标版本、部署与维护按项目确认。本文用本地关系数据库演示一项故障:退款金额不变但挂到另一家商户订单,如何在事务提交前发现并回滚。
数据模型与事务职责
示例仅处理一个项目和CNY整数分。original_order保存旧订单,以商户、渠道和原单号唯一;original_refund通过外键关联原订单。target_order用source_id唯一映射旧订单,target_refund保留source_refund并关联目标订单。数据库是空白目标演练,重复执行不覆盖历史结果。
事务中先复制订单与退款,再核原业务身份、金额与退款关联,只有检查通过才提交。外键只能证明目标订单存在,不能证明退款挂到了正确业务对象,因此必须沿目标订单source_id反查原订单。金额相同也不能省去这一步。
完整SQL与核心转换逻辑
import sqlite3
SCHEMA = '''
PRAGMA foreign_keys=ON;
CREATE TABLE original_order(
id TEXT PRIMARY KEY, merchant TEXT NOT NULL, channel TEXT NOT NULL,
order_no TEXT NOT NULL, paid_cents INTEGER NOT NULL CHECK(paid_cents>=0),
UNIQUE(merchant,channel,order_no));
CREATE TABLE original_refund(
id TEXT PRIMARY KEY, order_id TEXT NOT NULL REFERENCES original_order(id),
cents INTEGER NOT NULL CHECK(cents>=0));
CREATE TABLE target_order(
id TEXT PRIMARY KEY, source_id TEXT NOT NULL UNIQUE REFERENCES original_order(id),
merchant TEXT NOT NULL, channel TEXT NOT NULL, order_no TEXT NOT NULL,
paid_cents INTEGER NOT NULL CHECK(paid_cents>=0),UNIQUE(merchant,channel,order_no));
CREATE TABLE target_refund(
id TEXT PRIMARY KEY, order_id TEXT NOT NULL REFERENCES target_order(id),
source_refund TEXT NOT NULL UNIQUE REFERENCES original_refund(id),
cents INTEGER NOT NULL CHECK(cents>=0));
'''
def database():
db = sqlite3.connect(':memory:')
db.executescript(SCHEMA)
db.executemany('INSERT INTO original_order VALUES(?,?,?,?,?)',
[('o1','M1','WX','17',1000),('o2','M2','WX','17',2000)])
db.execute('INSERT INTO original_refund VALUES(?,?,?)', ('r1','o1',100))
db.commit()
return db
def migrate(db, mode='normal'):
try:
db.execute('BEGIN IMMEDIATE')
for ident, merchant, channel, number, cents in db.execute('SELECT * FROM original_order').fetchall():
if mode == 'missing' and ident == 'o2':
continue
if mode == 'balanced_error':
cents += 100 if ident == 'o1' else -100
db.execute('INSERT INTO target_order VALUES(?,?,?,?,?,?)',
('new-'+ident,ident,merchant,channel,number,cents))
for ident, order, cents in db.execute('SELECT * FROM original_refund').fetchall():
destination = 'new-o2' if mode == 'wrong_refund' else 'new-'+order
db.execute('INSERT INTO target_refund VALUES(?,?,?,?)',
('new-'+ident,destination,ident,cents))
count = db.execute('SELECT COUNT(*) FROM original_order').fetchone()[0]
matching = db.execute('''SELECT COUNT(*) FROM original_order o JOIN target_order t
ON t.source_id=o.id WHERE t.merchant=o.merchant AND t.channel=o.channel
AND t.order_no=o.order_no AND t.paid_cents=o.paid_cents''').fetchone()[0]
if count != matching:
raise ValueError('ORDER_DIFFERENCE')
refund_count = db.execute('SELECT COUNT(*) FROM original_refund').fetchone()[0]
matching = db.execute('''SELECT COUNT(*) FROM original_refund r
JOIN target_refund t ON t.source_refund=r.id
JOIN target_order o ON o.id=t.order_id
WHERE o.source_id=r.order_id AND t.cents=r.cents''').fetchone()[0]
if refund_count != matching:
raise ValueError('REFUND_DIFFERENCE')
db.commit()
return 'COMMITTED'
except (ValueError, sqlite3.IntegrityError) as error:
db.rollback()
return str(error)
if __name__ == '__main__':
db = database()
assert migrate(db) == 'COMMITTED'
assert db.execute('SELECT COUNT(*) FROM target_order').fetchone()[0] == 2
assert db.execute('SELECT order_id FROM target_refund').fetchone()[0] == 'new-o1'
db.close()
for mode, reason in [('missing','ORDER_DIFFERENCE'),('balanced_error','ORDER_DIFFERENCE'),
('wrong_refund','REFUND_DIFFERENCE')]:
db = database()
assert migrate(db, mode) == reason
assert db.execute('SELECT COUNT(*) FROM target_order').fetchone()[0] == 0
assert db.execute('SELECT COUNT(*) FROM target_refund').fetchone()[0] == 0
db.close()
print('12 local transaction checks passed')
正常输入输出与三个异常
正常基准中M1与M2各有WX单号17,分别1000分与2000分,r1为o1退款100分。正常返回COMMITTED,目标保留两单且退款关联new-o1。
missing故意丢掉o2,balanced_error把两单一增一减,均返回ORDER_DIFFERENCE;wrong_refund保持退款100分,却挂到new-o2,返回REFUND_DIFFERENCE。三类失败都会回滚,目标订单与退款均为零,原基准保持。
复现步骤与本地检查
Python 3.10或更新版本自带sqlite3。保存为upgrade_transaction.py,运行python upgrade_transaction.py。本次12项本地事务检查通过,源代码SHA-256、Python及SQLite版本和输出均保存。它是构造数据验证,不是微订产品、客户项目或云资源实测。
示例依赖SQLite整数列的亲和性和CHECK约束,未提供外部输入API或完整类型清洗,生产导入还需严格验证原始类型、币种、非空字符串和完整数据范围。每个数据库对象限定为一个项目;多项目系统应把项目身份加入唯一键和权限范围。
上云方案应补齐的一致性条件
若正式业务采用关系数据库,可由同一事务保存映射与验收结果;对象存储可保留受控基准文件,审计记录保存转换版本和差异。组件按职责选择,本例没有使用任何云服务,也不主张微订采用这一架构。
示例在固定内存数据库中演练,没有线上写入、分批大数据或网络调用。真实升级应说明一致性快照、增量追平及切换窗口。已发生的支付退款不在本地事务内,数据库回滚不会撤销外部动作;因此复制演练中不应调用真实支付退款接口。
事务成功也只证明本例检查范围。需要额外验证订单状态、结算明细、金额分摊、数据规模及备份恢复。正式切换后有新业务时,恢复应保留新单和回执,不能直接套用空白演练的整库回滚。
把技术输出用于方案判断
现成产品的采购评估先核商家自营与多商户关系,再核SaaS、私有化或源码安装的服务范围。标准功能、部署、升级与许可分别确认,按同范围比较投入。
微订第一方公开范围包括多商户、商家后台、骑手及抽成结算;本文代码是独立演示,没有证明其数据库、云部署或升级策略。项目验收可要求服务方提供同号订单、金额抵消、退款错挂与正常转换结果,将目标版本和维护责任写入交付清单。
作者:微订(上海逊柯计算机科技有限公司)。