WooCommerce库存减少不正确？

学完这篇，你能按固定顺序排查出 WooCommerce 库存扣多了、扣少了或者压根不扣的原因，并把数字改回正常。

第一步：先分清是哪一种「不正确」

这一步要做的，是把模糊的「库存不对」变成一个具体现象，否则后面全是瞎猜。打开 产品 → 所有产品，记下出问题那件商品的 SKU、当前库存数字，再去 订单 列表筛出最近 10 笔包含该商品的订单，把数量加总对一遍。三种结果对应三条不同的排查路线：

• 库存比实际少 → 扣多了，重点查第四步和第六步
• 库存比实际多 → 扣少了，重点查第二步和第三步
• 数字完全不动 → 根本没扣，重点查第三步

注意：不要凭印象判断「应该是 50 件」。先去仓库点一遍实物，再比对系统数字，不然你会修一个不存在的问题。

第二步：检查全局的「保留库存」设置

这一步是找出最容易被误判成 bug 的机制。进入 WooCommerce → 设置 → 产品 → 库存，看「保留库存（分钟）」（Hold stock (minutes)）这一项，默认值是 60。

它的含义是：顾客下单后订单处于「待付款」状态时，库存已经被临时占用了。也就是说顾客没付钱，你后台的库存数字照样往下掉，满 60 分钟订单被自动取消后才归还。很多店主看到这里以为系统乱扣，其实这是设计行为。填 0 表示不保留，待付款订单不占库存。

注意：这一栏填的是分钟，不是秒。想改成 30 分钟就填 30，别填 1800。

在这同一页还要确认「启用库存管理」已勾选——没勾的话下面所有设置都不生效。

第三步：检查产品级的库存开关

这一步定位单件商品自己的设置。产品 → 编辑该商品 → 产品数据 面板 → 左侧「库存」选项卡，逐项核对：

• 「管理库存？」必须勾上，否则这件商品的库存永远不扣
• 「库存数量」填的是真实可售数，不是已售数
• 「库存状态」如果被手动改成「有货」，WooCommerce 会忽略数量限制，看起来就像永远不扣
• 「允许缺货预订？」勾上后数量可以变成负数，容易被误认为扣多了

如果这是可变产品，库存要设在每个「变体」上，父级产品的「管理库存？」保持不勾。两边都勾会出现两套数字互相打架。

第四步：检查订单状态与库存回滚

这一步确认订单状态变化有没有被漏掉。WooCommerce 的规则是：没开保留库存时，订单进入「处理中」或「已完成」才真正扣减；订单从「待付款」变成「已取消」或「失败」，之前占用的库存会被退还。

在 订单 列表里筛一遍「待付款」和「已取消」，有没有一堆陈年旧单堆在那里。命令行下可以直接看：

wp wc order list --status=pending --user=1 --fields=id,status,total

注意：手动在后台把订单状态改来改去（比如 已完成 → 处理中 → 已完成），部分插件会重复触发一次扣减，这是「扣多了」的常见来源。

第五步：确认定时任务在运行

这一步解决「保留库存永远不释放」。自动取消待付款订单靠的是 woocommerce_cancel_unpaid_orders 这个定时任务，它依赖 WP-Cron，而 WP-Cron 只在有人访问网站时才触发。站点流量低的时候，任务可能几小时才跑一次。

装一个 WP Crontrol 插件，进 工具 → Cron 事件，搜索 woocommerce_cancel_unpaid_orders，看它的「下次运行」时间是不是正常滚动。命令行查看：

wp cron event list --fields=hook,next_run

注意：如果你在 wp-config.php 里写了 define('DISABLE_WP_CRON', true)，就必须真的在服务器 crontab 里配好定时请求，否则等于把所有定时任务全关了。

第六步：排除缓存和插件冲突

这一步处理「后台看到的数字和数据库不一致」。先到 WooCommerce → 状态 → 工具，点「清除瞬态」；如果服务器装了 Redis 或 Memcached 对象缓存，把缓存也清一遍。WooCommerce 会缓存产品对象，缓存不刷新时后台显示的是旧值。

再排查插件：POS 收银插件、订单编辑插件、批量改价插件、以及任何自定义结账流程的插件，都可能自己再扣一次库存。临时停用除 WooCommerce 核心外的全部插件，下一笔测试订单看是否恢复正常，然后逐个启用定位。

第七步：手动校正库存数字

这一步用来收尾。单个商品直接在产品编辑页改「库存数量」保存即可；批量校正用 WP-CLI：

wp wc product update 123 --stock_quantity=50 --user=1

如果你怀疑数据库层面不一致，可以比对一下 wp_postmeta 里的 _stock 和 wp_wc_product_meta_lookup 表的 stock_quantity 是否相同。

注意：动数据库之前先导出备份。另外不要再保留已经废弃的 _stock_status 手动改动习惯，让 WooCommerce 按数量自动推导。

小结

• 「保留库存（分钟）」默认 60，待付款订单会占库存，这是机制不是 bug
• 产品级的「管理库存？」没勾，库存永远不扣；可变产品库存要设在变体上
• 订单进入处理中／已完成才扣减，取消和失败会回滚
• woocommerce_cancel_unpaid_orders 依赖 WP-Cron，低流量站点要配系统 cron
• 清除瞬态和对象缓存能解决大部分「显示不一致」
• POS、订单编辑类插件是重复扣减的高发区，用停用插件法逐一定位
• 改数据库前先备份