必须由服务端生成唯一订单号并透传给Zion SDK,客户端随机生成易重复;数据库需加唯一索引兜底;支付回调须验签+幂等更新,防止重复发货。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用函子Zion做支付时,订单号重复会导致支付失败、权益发放错乱、财务对账异常,甚至引发用户投诉和资损。这并非理论风险,而是已在多个生产环境复现的确定性问题。
Zion SDK默认生成逻辑不保证全局唯一
Zion 1.8.3及之前版本的客户端SDK在未传入outTradeNo时,会调用内部generateRandomOrderId()方法生成8位随机字符串作为订单号。该方法基于Math.random(),无时间戳、无业务上下文、无机器标识,【单进程内并发调用100次即有约3%概率出现重复】。若服务部署多实例或前端存在批量下单行为,冲突率呈指数上升。
这一步不能依赖——哪怕你本地压测1000次没撞上,上线后QPS过500就可能每天触发数起重复。
必须由服务端强制生成并透传
正确做法是:所有下单请求必须先经你自己的后端接口,由服务端生成符合幂等要求的outTradeNo,再通过Zion SDK的createOrder({ outTradeNo: 'xxx' })显式传入。
生成规则需满足:用户ID + 业务类型 + 精确到毫秒的时间戳 + 随机盐(如6位CRC32),总长控制在32字符内。例如:U123456_VP_1731501050123_8a2f1c。
注意:不要用UUID或纯时间戳——前者长度超标且Zion部分版本截断处理,后者在毫秒级并发下必然重复。
数据库层必须加唯一索引兜底
方法一:在订单表order_no字段上执行:
ALTER TABLE `orders` ADD UNIQUE INDEX `uk_order_no` (`order_no`);
方法二:若已分库分表,无法直接建全局唯一索引,则改用order_no + tenant_id联合唯一约束,并确保tenant_id在分片路由中稳定映射。
【唯一索引是最后一道不可绕过的防线,缺失则等于裸奔】。Zion回调通知、补单脚本、对账任务全部依赖此约束识别重复插入。
支付回调必须按Zion原始报文验签后更新
第一步:收到Zion回调时,先用原始POST body(非JSON解析后)+ 你的appSecret重新计算HMAC-SHA256签名,比对sign字段。
第二步:验签通过后,用回调中的out_trade_no查询本地订单。若不存在,说明是首次到达→创建订单并标记状态为“待发货”;若存在且状态为“已发货”,直接返回success;若存在但状态非终态(如“创建中”),执行状态机CAS更新:UPDATE orders SET status = 2 WHERE order_no = ? AND status = 1。
第三步:仅当CAS更新影响行数为1时,才触发发货逻辑。否则跳过——这是防止Zion因网络抖动重推回调导致重复发货的核心机制。


















