WMS 对接 PDA 扫码枪：扫描数据丢包的排查实战

我跟你说，跑了这么多年，见过太多仓库门口的骂战——司机骂仓库卸货慢，仓库骂司机到得晚。但有一种骂战最冤：操作员举着 PDA 扫码枪在收货区骂娘，说"这破枪扫了跟没扫一样"。扫码枪数据丢失排查这事，我在 WMS 对接 PDA 扫码枪的现场看过不止一回，枪十有八九是背锅的。

大半夜的，一个托盘扫丢了十几箱

那是去年秋天，具体几月我记不清了，反正是旺季前。我在 Fontana 一家 3PL 仓的码头上等提货，旁边收货区一个小伙子正收一个托盘的货。他拿着 PDA，"滴、滴、滴"扫得挺欢，扫完把枪往腰上一别，电脑上一点——傻眼了。一个托盘四十来箱货，系统里只进了二十多条。

小伙子第一反应：枪坏了。换电池，重启，再扫一遍，数量还是对不上。主管过来了，脸一黑："枪不行就换一把！"换了把新枪接着扫，嘿，这回全进去了。皆大欢喜？没过半小时，另一台枪又出毛病了，扫了不进数。

我当时在旁边看热闹，心里直犯嘀咕：哪有这么巧，枪一把接一把坏？后来跟他们 IT 小哥聊了两句，人家一句话点醒我："枪没问题，是那一片 WiFi 有死角。"收货区最里面那排货架，正好在两个无线 AP 覆盖的夹缝里，PDA 扫完数据发不出去，界面上还显示"已扫描"，操作员根本不知道数据丢了。

你看，现场的人永远先怪枪。可枪就是个扫码的，它扫到了、滴了一声，它的活儿就干完了。数据从枪到 WMS，中间要过好几道坎，丢在哪一坎，枪都不知道。

还有一回更邪乎：扫是扫了，数是半分钟后才到

另一回是在亚利桑那 Chandler 附近一个电商仓，也是等货的时候看的。那边的问题不是丢，是慢。操作员扫完一箱，屏幕上半天没反应，他以为没扫上，又扫一遍。结果系统里同一箱货进了两次，库存直接多出一倍。盘库的时候对不上，折腾了一整晚。

他们 IT 查了半天，根子出在中间那层软件上。PDA 扫完的数据不是直接进 WMS 的，中间有个采集服务，先攒一批再往 WMS 送。那天网络抖了一下，攒的数据卡住了，半分钟后才一股脑倒进去。操作员在现场等不及，重复扫，WMS 那边又没有做重复校验，来者不拒，全收了。

这事说明啥？说明扫码枪数据丢失、延迟、重复，压根不是"枪"的问题，是"链路"的问题。从枪头到系统，数据要走四段路：枪本身、仓库的无线网络、中间的采集服务、最后的 WMS。哪一段掉链子，现场看到的症状都一样——"扫了没进系统"。

排查链路：四段路，一段一段掐

我跟你说，排查这事不能靠猜，得一段一段掐。顺序也有讲究，别一上来就换枪，枪是最后才查的。

第一段：先看路，也就是仓库的 WiFi。 这是丢包的第一大户。PDA 都是走无线传数据的，仓库里货架一多、金属一多，信号死角遍地都是。排查办法土但管用：拿着 PDA 在出问题的区域走一圈，看信号强度；或者让 IT 在后台看那台设备的断线记录。很多仓的 AP 是按"覆盖面积"装的，不是按"作业动线"装的——收货区、上架区这些枪用得最狠的地方，恰恰信号最弱。

第二段：再看枪和人。 电量低的时候，有些 PDA 会自动降功率，WiFi 先掉；扫描头脏了，扫是扫上了，解码慢，操作员没等"滴"声确认就挪开了；还有的枪设成了"键盘模式"，扫出来的数据直接填进输入框，焦点一跑偏，数据就进了空气里。这些都是小毛病，但现场排查时经常被跳过，因为大家都觉得"枪嘛，能滴就是好的"。

第三段：查中间的采集服务。 问 IT 三个问题：数据是实时传还是攒批传？断网了数据缓存在哪、重连后补不补传？重复扫描有没有去重？很多丢包案子，枪扫了、网也通了，数据躺在中间服务的缓存里没送出去，或者送出去了 WMS 没回执，中间服务以为没送到又送一遍——丢和重，经常是同一个病根的两副面孔。

第四段：最后看 WMS 那头。 接口有没有做幂等（同一条码扫两次只认一次）？时间戳对不对得上？WMS 的日志里能不能查到每一条扫描记录的到达时间？日志齐的系统，排查就是翻记录；日志不齐的，只能靠猜。

我给你画个排查顺序，记住这个口诀：先看路（网络），再看人（操作习惯），再看中转（采集服务），最后看枪和系统。按这个顺序走，一上午基本能定位。我见过太多仓反着来：先换枪，换完换软件，最后才发现是 AP 位置不对，白白折腾两三天。

顺带提一句：排查的时候记得让 IT 把 PDA 的系统时间和 WMS 服务器时间对一下。两边差个几分钟，日志就对不上号了——你拿着枪上的时间去翻 WMS 日志，翻破头也找不到那条记录。这个坑我见人踩过，提一嘴，省你半天功夫。

一个反常识的判断：实时不一定比批量好

说到这儿，讲个反常识的。很多人觉得，扫描数据就该实时进 WMS，越快越好，批量上传是落后的做法。错了。

实时上传，网络一抖就丢，丢了操作员还不知道——这是最坑的"静默丢失"。批量上传（枪上先存着，过几分钟或扫完一批统一传），网络抖了数据还在枪里，顶多晚到几分钟，不会无声无息地没。但批量的代价是延迟：WMS 里看到的永远是几分钟前的状态，旺季抢单、紧急调拨的时候，这几分钟可能就是事。

所以这事没有标准答案，得看你的活儿：收货、上架这种"扫完就走"的环节，批量+补传机制更稳；分拣、复核这种"扫完立刻要反馈"的环节，实时是必须的，但网络必须按作业动线重新布好。Trade-off 就摆在这儿：你要"快"，就得在网络上花钱；你要"稳"，就得接受几分钟延迟。最怕的是又想快又不想花钱，最后两头不靠。

收货区操作员使用 PDA 扫码作业