PAYATHON 2026

Laravel Eloquent 如何只返回 fk_customer_id 非空的序列化商品?

数据小许

直接查询 serialization 时,在主查询中加入 whereNotNull('serializations.fk_customer_id');查询 Receiving 时,用 whereHas() 筛选包含已售出商品的父记录,再用带条件的 with() 限制返回的 serializeItems。

以下按题目中的业务规则判断:fk_customer_id 非 NULL 表示商品已售出。

为什么现有条件没有达到预期

默认分支没有对 fk_customer_id 添加非 NULL 条件,所以仍会返回库存商品。

在 invoice_no 分支中,下面的条件作用于 Receiving 主查询:

Receiving::with('serializeItems')
    ->whereNotNull('fk_customer_id')

with() 会另外查询关联记录,后面的 whereNotNull() 不会自动作用于 serializations 表。如果主查询涉及的表中没有这个字段,还可能产生 SQL 错误。

筛选父记录和筛选关联集合分别由两个方法处理:

  • whereHas('serializeItems', ...):只返回存在符合条件商品的 Receiving。
  • with(['serializeItems' => ...]):限制每个 Receiving 实际加载哪些商品。

如果要同时排除不符合条件的父记录和关联商品,需要使用这两个约束。

默认分支:直接限制 serializations

在默认分支中加入下面的条件,指定要检查的表:

->whereNotNull('serializations.fk_customer_id')

下面展示筛选和关联加载部分,原来的 leftJoin()、selectRaw() 等展示逻辑可以继续接在查询后面。示例使用普通 where() 匹配包含搜索词的序列号,不依赖未提供实现的搜索方法:

$pattern = '%' . $request->q . '%';

$query = serialization::with([
    'fk_receiving_id',
    'fk_receiving_id.fk_vendor_id',
    'fk_receiving_invoice_no',
])
    ->whereNotNull('serializations.fk_customer_id')
    ->where('serializations.serial_emei_number', 'like', $pattern);

$items = $query->limit(10)->get();

如果保留现有的 whereLike(),也应保留上述非空条件。使用包含匹配还是精确匹配,应按页面的搜索要求决定;完整序列号校验通常可以使用 =。

invoice_no 分支:同时约束父记录和关联商品

将原来的 Receiving::with(...)->whereNotNull(...) 替换为以下查询开头:

$soldItems = function ($query) {
    $query->whereNotNull('serializations.fk_customer_id');
};

$query = Receiving::with([
    'serializeItems' => $soldItems,
    'serializeItems.fk_receiving_id.fk_vendor_id',
])
    ->whereHas('serializeItems', $soldItems);

后续再接发票号、供应商搜索、联表、展示字段和汇总等原有逻辑。查询只会返回至少包含一个已售出商品的 Receiving,且 serializeItems 集合中只加载已售出商品。

序列号搜索必须与非空条件落在同一条关联记录上

原代码还通过 WhereHasLike('serializeItems', ...) 搜索序列号。如果用两个独立的关联存在性条件分别检查已售出商品和匹配序列号的商品,这两个条件可能由不同商品满足。

例如,同一张单据下有一个已售出商品 A 和一个未售出商品 B。用户搜索 B 时,A 可以满足已售出条件,B 可以满足序列号条件,父记录仍可能被选中。

当该分支也需要按序列号筛选时,应将两个条件放进同一个 whereHas()。用下面的条件替换前面的 whereHas('serializeItems', $soldItems),并移除原来单独的 WhereHasLike('serializeItems', ...):

$pattern = '%' . $request->q . '%';

$query = Receiving::with([
    'serializeItems' => $soldItems,
    'serializeItems.fk_receiving_id.fk_vendor_id',
])
    ->whereHas('serializeItems', function ($query) use ($pattern) {
        $query
            ->whereNotNull('serializations.fk_customer_id')
            ->where('serializations.serial_emei_number', 'like', $pattern);
    });

这样,同一条 serializations 记录必须同时满足已售出和序列号匹配两个条件。此时预加载仍会返回该父记录下的所有已售出商品;如果关联集合也只应包含匹配序列号的商品,需要将相同的序列号条件加到 with() 的闭包中。

检查搜索条件是否绕过了非空限制

题目没有提供 whereLike() 和 WhereHasLike() 的实现,因此无法确定它们内部是否使用了 orWhere(),也无法仅凭方法名判断多个搜索条件如何组合。

如果搜索条件包含 OR,应把这些条件放进闭包,让最终逻辑保持为:

fk_customer_id IS NOT NULL
AND (搜索条件一 OR 搜索条件二)

例如:

$query
    ->whereNotNull('serializations.fk_customer_id')
    ->where(function ($search) use ($pattern) {
        $search->where(
            'serializations.serial_emei_number',
            'like',
            $pattern
        );
        // 需要 OR 匹配的其他搜索字段放在这个闭包中。
    });

提交退货时,也要重新查询并检查选中的商品是否满足 fk_customer_id IS NOT NULL。页面搜索结果只能限制当时的可选项,不能代替提交时的业务校验。

备注:内容仅供参考。