Laravel Eloquent作用域函数失效咨询及正确实现方法求助

核心问题 #

你当前的代码存在两个致命错误，导致结果完全不符合预期：

1. 作用域实现逻辑错误：scopeNonDepletedBottles中使用$this->bottles()->count()是统计当前模型实例的未耗尽瓶子数，而非针对查询中每个InventoryItem模型做关联统计。这会导致所有查询的模型都用同一个固定值去比较，完全失去了筛选意义。
2. 筛选条件符号写反：案例3和案例4的condition参数完全搞反了，直接导致筛选逻辑与预期相反。

关于作用域的适用性 #

此处使用作用域是合适的，因为这个“统计未耗尽瓶子数并与指定字段比较”的逻辑是可复用的，用作用域能让代码更简洁、易维护，符合Eloquent的最佳实践。

正确实现方式 #

第一步：修复作用域函数

推荐用withCount实现，简洁且易读：

use Illuminate\Database\Eloquent\Builder;

public function scopeNonDepletedBottles(Builder $query, string $column, string $condition): Builder
{
    // 为每个InventoryItem统计关联的未耗尽瓶子数量，生成`bottles_count`字段
    return $query->withCount(['bottles' => function (Builder $q) {
        $q->where('is_depleted', false);
    }])
    // 比较统计值与指定字段（支持JSON路径，如`info->low_level_warning`）
    ->whereColumn('bottles_count', $condition, $column);
}

如果不想在查询结果中包含bottles_count字段，可改用子查询方式：

use Illuminate\Database\Eloquent\Builder;
use App\InventoryItemBottle;

public function scopeNonDepletedBottles(Builder $query, string $column, string $condition): Builder
{
    // 构造子查询：统计当前InventoryItem的未耗尽瓶子数
    $subquery = InventoryItemBottle::selectRaw('COUNT(*)')
        ->whereColumn('inventory_item_id', 'inventory_items.id')
        ->where('is_depleted', false);

    // 执行统计值与目标字段的比较
    return $query->whereRaw('(' . $subquery->toSql() . ') ' . $condition . ' ' . $column, $subquery->getBindings());
}

第二步：修复筛选逻辑的条件符号

• 案例3（低于阈值）：需要未耗尽瓶子数小于low_level_warning，所以condition参数应为<：

case 3: // 低于阈值：未耗尽瓶子数 或 info->quantity 小于 low_level_warning
    $query->where(function ($q) {
        $q->nonDepletedBottles('info->low_level_warning', '<')
          ->orWhere(function ($q) {
              $q->whereColumn('info->quantity', '<', 'info->low_level_warning');
          });
    });
    break;

• 案例4（高于阈值）：需要未耗尽瓶子数大于high_level_warning，所以condition参数应为>：

case 4: // 高于阈值：未耗尽瓶子数 或 info->quantity 大于 high_level_warning
    $query->where(function ($q) {
        $q->nonDepletedBottles('info->high_level_warning', '>')
          ->orWhere(function ($q) {
              $q->whereColumn('info->quantity', '>', 'info->high_level_warning');
          });
    });
    break;

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