上个月一个做知识付费的站长来找我,说他的订单系统出了个邪门 bug,查了两天没查出来。

事情是这样的:有个用户买了课,付了钱,然后申请退款,退款也到账了。结果后台一看,这笔订单的状态显示"已支付",但钱明明已经原路退给用户了。等于用户免费拿了课,他一分钱没收到。

他查了两天,日志翻了个遍,没找到原因。我让他把订单状态字段的定义发我。

他发来一张表,状态字段里塞了七八个值:待支付、支付中、已支付、已发货、已完成、已退款、已关闭、退款中。我一看,心里有数了。

我说你这不是 bug,是你状态机从根上就设计错了。他一脸不信,说状态字段设计得挺细啊,怎么错了。

下面就是我当时一步步给他拆的过程。网上讲"支付接口怎么接"的文章一堆,但真没人认真讲过"订单状态到底该怎么设计、怎么流转、怎么不被并发改乱"这件事。这篇就是补这个空白的。

状态不是越多越细越好,是"够用"就行

我先说第一个问题:你的状态太多了。

他那八个状态里,光"退款"就拆了"退款中"和"已退款"两个,还有个"支付中"。我说你自己想想,客服后台查一笔订单,看到"退款中"这三个字,能确定这单现在到底是啥情况吗?钱退了没?退到哪一步了?单看这个字段,谁都猜不出来。

状态字段的本质,是给一笔订单的"生命线"画几个关键节点,让人一眼能看懂"这单现在卡在哪一步"。它不是让你把业务里所有中间环节都塞进去的。塞得越多,越没人看得懂,越容易出乱。

我给他的建议是,核心状态留 5 个就够:

待支付——订单建了,钱还没到。

已支付——回调确认钱到账了。

已发货(或已完成)——业务处理完了,课开通了、货发了。

已关闭——订单作废,比如超时没付被关了、用户取消了。

已退款——钱退回去了,这单彻底结束。

就这 5 个,覆盖他 99% 的场景。剩下的"退款中""支付中"这些,不是不能有,是不该塞进"订单状态"这一个字段里,得单独拎出来,下面讲。

"支付中"这个状态,我劝你删掉

他问,那"支付中"呢?用户点了支付、还没收到回调,总得有个状态表示吧。

我说这恰恰是你最容易栽的地方。"支付中"看着严谨,实际上是个你没法可靠判定的中间态。

你想想,用户点了支付,然后呢?他可能真在输密码,可能已经付了但回调丢了,可能付到一半又关掉了。你的系统,根本没法确定"支付中"这个状态到底意味着什么。一旦你设了这个状态,你就得写一堆逻辑去处理"卡在支付中"的订单——几秒算超时?超时了改成啥?回调来了怎么跳?全是给自己找麻烦。

正确做法是:别设"支付中",订单一直停在"待支付",直到回调确认成功,才改成"已支付"。

那"用户到底付没付、是不是回调丢了"这个问题怎么办?这压根不是状态字段该管的事,靠主动查单去解决。回调丢了怎么查、怎么补,我之前写过支付回调丢了怎么办?主动查单补单机制的正确设计,讲得很细,不再重复。

你就记住一句:状态字段只记录"确定的事",不确定的事,别硬塞进去。

状态只能往前走,不能往回跳

拆完状态,我继续问他:你这套状态之间,允许怎么跳?

他懵了,说没想过,就是业务代码里哪里需要就 update 一下。

问题就出在这。他的 bug,根源就是这里——退款回调把状态改成了"已退款",紧接着支付成功回调也到了,代码里没做任何约束,直接把状态又覆盖回"已支付"。一笔钱退了、订单却显示已支付,就是这么来的。

状态机最核心的一条铁律,就是单向、不可逆。支付订单的正常流转,是这么一条单行道:

待支付 → 已支付 → 已发货 → (已退款)

"已退款"和"已关闭"是两条岔出去的终态,一旦进去,锁死,不能再回到"已支付"或"待支付"。因为一旦允许回退,就会出他这种"退了钱、订单还显示已支付"的乱账。

落到代码上,就是你要写死一张"合法迁移表":

  • 待支付 能跳到:已支付、已关闭
  • 已支付 能跳到:已发货、已退款
  • 已发货 能跳到:已退款
  • 已关闭、已退款:终态,不能再变

任何不在这张表里的跳转,一律拒绝。比如"已退款"想跳回"已支付",直接拦下来。这张表,就是你整个状态机的骨架。

光有单向还不够,得防住"并发覆盖"

他听完说,那我回去把迁移表补上,问题就解决了吧。

我说还差最关键的一步。你那个 bug,表面是"状态被改回去",本质是并发——退款回调和支付回调几乎同时到达,两个请求都先读了"当前状态",发现是"待支付",然后各自去 update,后写的把先写的覆盖了。你光加迁移表,如果还是"先读后写",照样会被并发覆盖。

真正管用的是一招:别"先读后写",用"带条件的原子更新"。

比如退款回调要把订单从"已支付"改成"已退款",你不能这么写:

先查一下订单是"已支付",然后 update 成"已退款"

而要用数据库的原子操作,把"检查当前状态"和"改状态"合成一条:

update 订单 set 状态='已退款' where 订单号='xxx' and 状态='已支付'

关键就在 where 状态='已支付' 这半句。它保证:只有订单当前确实是"已支付"时,这次更新才生效。退款回调和支付回调同时到达,谁先满足条件谁先成功,另一个因为条件已经不满足了,更新影响行数为 0,自动被挡下。状态就永远不会被"改回"到不该回的地方。

这个"带条件的原子更新"思路,跟"幂等"是一回事——同一笔交易的回调不管来多少次,只能生效一次。幂等没做好导致重复扣钱的翻车,我写过支付重复扣款是怎么发生的?一个幂等键没做对,用户付了两次钱,那个案例本质上也是状态没防住并发,你可以对照着看。

迁移表怎么落地?别只写在文档里,要写进代码

他问,这张"合法迁移表",是写个文档放那,还是真写进代码?

我说必须写进代码,而且要写成一个统一入口,让所有状态变更都从这一个口子走。你想想,如果状态变更散落在几十个业务文件里,每处都自己写个 update,那迁移表就形同虚设——迟早有人加新逻辑的时候,绕开表直接改状态。

落地一般是这样:封装一个"状态迁移函数",比如 transition(order, from_state, to_state)。这个函数内部先查迁移表,确认 from_state → to_state 是合法的,合法才执行;不合法直接抛错。所有业务代码要改状态,都得调这个函数,不许自己裸写 update。

这样一来,迁移表就成了一个"闸门",所有状态变更都过这道闸,非法的跳转在源头就被拦住。这比"文档里写了、靠人自觉"可靠得多。

超时关单,也是状态机里的一环,别漏了

还有一件事,很多人设计状态机时容易漏:超时关单。

你有个"待支付"的订单,用户一直不付,超过一定时间就该自动关掉,状态从"待支付"变成"已关闭"。这个"关单"动作,本质上也是状态机的一次合法迁移——它就在迁移表里:"待支付 → 已关闭"。

但关单有个特殊之处:它是定时任务触发的,不是回调触发的。定时任务扫出一批"超时没付"的订单,然后批量把它们从"待支付"改成"已关闭"。

这里最容易出问题的是:定时任务改状态的时候,可能正好撞上用户的支付回调。用户卡着超时点付了钱,回调到了,同时关单任务也扫到了这单——一个要把"待支付"改成"已支付",一个要改成"已关闭",两个并发,又回到那个"先读后写"的老问题。

所以关单这个动作,一样要用"带条件的原子更新":

update 订单 set 状态='已关闭' where 订单号='xxx' and 状态='待支付'

关单只对"当前还是待支付"的订单生效。如果用户刚好付了、回调已经把状态改成"已支付"了,那关单的 where 状态='待支付' 条件就不满足,这单不会被误关。关于"关单怎么设计才不误伤真单",那是另一个专门的话题——关单时间怎么定、关之前怎么查单确认、怎么防并发误伤,值得单独拎出来讲,这里先不展开。

状态、支付状态、发货状态,别揉进一个字段

他消化了一会儿,又抛出一个问题:那"部分退款"怎么办?一笔订单付了 100,退了 30,这单算"已退款"还是"已支付"?

我说问得好,这正好引出下一个关键点:订单状态、支付状态、发货状态,三个概念得分开存,别揉成一个字段。

因为它们仨的生命周期不同步。就说部分退款:订单还活着,但钱退了一部分。如果你只有一个状态字段,就没法表达"退了 30 块"这个事实——写"已退款"不对(订单没结束),写"已支付"也不对(钱少了)。

正确做法是拆开:

  • 订单状态:这笔订单业务上到哪一步了(待支付/已支付/已发货/已关闭/已退款)。
  • 支付状态:钱到了多少、退了没有(已付 100、已退 30)。
  • 发货状态:货发没发、课程开通没开通。

这样,部分退款就是:订单状态"已支付"、支付状态"已付 100 退 30"、发货状态"已发货"。三个字段各记各的,不打架。

他那个 bug 其实也沾了这个毛病——退款和支付全挤在"订单状态"一个字段里互相覆盖,才乱成那样。拆开之后,退款走"支付状态"和"退款金额",支付回调走"支付状态",订单状态只管业务流转,各司其职,想乱都难。

最后一件小事:状态变了,留个痕

拆完这些,我最后叮嘱他一句:状态改动的过程,得留痕。

很多系统只存"当前状态",不存"历史状态",结果出了事想回溯,只能靠猜。比如某笔订单现在是"已退款",但它是一开始就退款了,还是先支付、发货、再部分退款、最后全退?没有历史记录,你根本查不出来。

所以每条状态变更,都记一条流水:什么时候、从什么状态、变成什么状态、是谁(哪个回调/哪个操作)触发的。这张"状态流水表",平时没用,一出事,它是你唯一的线索。

他照着我说的,把状态从 8 个砍到 5 个、删掉"支付中"、补上迁移表、改成原子更新、拆开三个字段、加了状态流水表。改完后,那个"退了钱订单还显示已支付"的 bug 再也没出现过。

他后来跟我说,最大的收获不是修好了 bug,是终于明白一件事:订单状态不是个随便填填的字段,它是一套有规矩的机器。规矩立对了,后面对账、退款、发货全都顺;规矩没立,所有逻辑都在沙子上盖楼。

这句话,就是这篇最想跟你说的。