PHP仓库补货清单生成逻辑修复：replenish记录数量异常问题

业务规则 #

• 库存数据必须按Exp_date、location_type、location_id排序
• 库存数量大于未完成订单量时触发replenishment
• 补货后库位剩余库存优先分配给后续订单
• 仅location_type为RACK的库位需要补货，PICK类型库位可直接扣减库存，无需走补货流程

问题现象 #

已提供orders订单表、storages库存表的建表SQL与测试数据，预期输出2条补货记录，实际PHP代码运行后输出3条补货记录。

排查修复方向 #

1. 检查库位类型过滤逻辑 #

90%以上的同类问题都是未做库位类型前置过滤，把PICK类型库位的库存也纳入了补货触发判断，多生成1条无效补货记录。
修复方案：遍历库存池前先筛除所有非RACK类型的库位：

// 前置过滤仅保留RACK库位参与补货计算
$rackStorages = array_filter($storages, function($item) {
    return $item['location_type'] === 'RACK';
});

2. 检查排序逻辑是否生效 #

确认库存查询SQL或者PHP侧数组排序严格按照优先级Exp_date升序 > location_type排序 > location_id升序执行，排序错误会导致低优先级库存先被分配，原本可被高优先级库存覆盖的订单量被重复触发补货。
排序参考SQL：

SELECT * FROM storages ORDER BY exp_date ASC, location_type ASC, location_id ASC;

3. 检查剩余订单量扣减逻辑 #

确认每次生成补货记录后，实时扣减对应未完成订单量，避免同一份订单量被重复匹配多批库存，生成多余补货记录。
正确逻辑示例：

// 初始化未完成订单总数量
$remainOrderQty = array_sum(array_column($orders, 'need_qty'));
$replenishRecords = [];

foreach ($sortedRackStorages as $storage) {
    // 订单已全部满足，终止循环
    if ($remainOrderQty <= 0) break;
    
    $currentStockQty = $storage['stock_qty'];
    // 触发补货逻辑
    if ($currentStockQty > $remainOrderQty) {
        $replenishQty = $remainOrderQty;
    } else {
        $replenishQty = $currentStockQty;
    }
    
    $replenishRecords[] = [
        'location_id' => $storage['location_id'],
        'exp_date' => $storage['exp_date'],
        'replenish_qty' => $replenishQty
    ];
    
    // 实时扣减未完成订单量
    $remainOrderQty -= $replenishQty;
}

4. 检查补货触发条件边界值 #

确认触发条件是库存数量 > 未完成订单量，不要误写为>=，避免刚好相等的边界场景多触发一次补货。

内容的提问来源于stack exchange，提问作者Oza Oza