先说结论：新仓上线，接口联调的时间永远不够用。区别只在于，你是打算在上线前把坑踩完，还是上线后一边接客服电话一边踩。我见过太多项目把八成时间花在库位规划和设备调试上，接口联调只留最后一周——结果上线当天，系统商、快递、平台三方互相甩锅，仓库里几百个包裹打不出面单。
沙箱不是摆设：先把环境对齐，再谈测试
2024 年，加州安大略一个 12 万平方英尺的新仓，上线前一周我去看联调。沙箱里跑得很顺：下单、打单、发货一条龙，演示给老板看人人点头。结果上线第一天就炸了：沙箱用的面单模板和生产环境不是同一套，生产模板里快递单号的校验逻辑多了一位，面单打出来扫不上，包裹在分拣线口堆了半小时，整条线停摆。
教训很具体：沙箱和生产的环境配置必须逐项对齐——面单模板、打印机型号和驱动、承运商账号、服务器时区，一个都不能差。特别提醒承运商账号：测试账号和正式账号的权限经常不一样，我见过测试账号能查报价打面单、却拉不到轨迹信息，结果轨迹回传这条链路到上线当天才第一次真跑。联调开始前，先拉一张两栏对照表，沙箱和生产逐项打勾，缺的补齐再开测。
还有沙箱里的数据：别用玩具数据。用几千个真实的 SKU、真实的重量体积、你真正会用的快递产品代码，再掺一些带公寓号、邮政信箱、偶尔写错的地址。我见过的接口 bug，一大半不是逻辑错，是数据格式错——而玩具数据会把这些问题全藏起来。
联调第一天还有一件小事：让三方把接口文档的版本号写下来。快递商的接口文档一年能更新三四次，字段变了经常不通知，沙箱里调通的可能是旧版，上线跑的却是新版。我习惯让三方在联调启动会上把"当前生产正在跑的版本号"白纸黑字确认一遍，省得上线后为一个字段的变更互相甩锅。
测试单清单：重点测"坏情况"，不测"好情况"
正常单人人都会测，真正要命的是异常单。我的清单里至少要有这几类：地址缺失或格式错误、超重超尺寸、SKU 不存在、库存为负、下单后取消、一个订单拆成多包裹、多个订单合一包裹。每类至少跑 3 单，看 WMS、平台、快递三方的状态能不能对上——最常见的坑是三方状态不一致：平台显示已发货，WMS 还卡在待拣货，客服的电话就是这么来的。
ERP 那条线也要单独测一轮：采购单收货、ASN 入库、库存快照回写。经典老坑是期初期末对不上：ERP 显示收了 500 件，WMS 实收 480 件，不到月末结账没人发现，对起账来就是一场灾难。在沙箱里完整跑一轮收货到盘点的闭环，数字对上了再上线。
权限也别忘了测。拣货员的账号能不能看到不该看的采购价？新员工入职第一天，扫码枪一扫看到全场成本价，这种事故我见过。权限矩阵在沙箱里按角色走一遍：谁能调库存、谁能删单、谁能看报表，一个一个试。权限问题上线后再收，是最得罪人的活。
还有两类经常被漏掉的。第一，大促单：黑五前一周，用脚本往沙箱里灌一天 2 万单的量，看接口限流、消息队列会不会堵。平时每秒 10 单跑得好好的，大促每秒 200 单直接把接口打穿，这种事我见过不止一次。第二，退货单：十个新仓有九个上线前没在沙箱里完整跑过一单退货。退货的链路和正向完全是两套逻辑——平台退货单、WMS 收货、质检、上架、库存回写平台，任何一个环节断了，退货就卡在半路。上线后第一周退货一进来，仓库直接乱套。
联调期间每天收尾做一件事：对账。把平台、WMS、快递三方的订单状态导出来，同一批单号三个状态必须一致。对账脚本联调第一天就写好，每天自动跑，别靠人工肉眼看。三方状态对不上的单子，就是第二天要优先修的 bug。
切换日：先想好怎么往回退，再想怎么往前冲
上线前先定回滚线，而且要写下来：比如切换后 2 小时内出库准确率跌破某个值、或者接口报错率超过阈值，立刻切回老系统或手工单。回滚线贴在作战室墙上，而不是"到时候再看"。回滚演练至少做一次：切换前一周，模拟接口大面积报错，把回滚流程走一遍并计时。真到切换日，流程应该是肌肉记忆，不是临场发挥。
切换当天，老系统别急着关。新老并行跑半天到一天：订单两边都进，出库以老系统为准，新系统做影子验证。具体做法：新系统打出的前 50 张面单，和老系统的逐单比对——地址、时效产品、单号，一行一行对，没问题再放量。比对表留档，出了问题能追溯到是哪一张单先出的错。并行期的成本是双倍人力，省这点钱，赌的是上线第一天的几千单——这笔账不划算。
切换前夜还要做数据冻结：老系统的在途库存、未完成订单全部导出快照，新系统上线后第一件事就是拿这批数做期初对账。期初数错了，后面每一笔都是错的，查都查不回来。这个快照文件存好，至少保留三个月。
值班表也要排好：接口出问题最多的时间，是切换后第一个夜班。开发、仓库主管、客服三方必须有人在场，拉一个群，联系方式置顶。别等出事了再一个个打电话找人。值班表提前三天发出，所有人确认收到——切换日当天才发现有人请假，是最蠢的翻车方式。
客服的话术提前准备好：面单打不出、轨迹不同步、库存对不上，每种情况的标准回复口径和升级路径写好，客服不用现场编。切换日客服接到的第一个电话，决定了后面几百个电话的处理效率——口径统一，问题收敛才快。
你的沙箱里，上一次完整跑通一单退货是什么时候？从平台发起退货，到 WMS 收货、质检、上架、库存回写平台，全链路走完。如果想不起来具体日期，切换日最好往后挪一周。接口联调没有"差不多"，上线那天，生产环境会把你所有"差不多"的地方，一个一个指出来——而指出的方式，通常是停线。
