Laravel使用Eloquent时如何在模型作用域中正确拼接多区间查询条件

你当前的实现完全混淆了查询构建器的本质：$query是Laravel的数据库查询构建器对象，不是可以拼接字符串的文本，直接把拼了方法名的字符串和对象做字符串连接，自然会触发“查询对象无法被转换为字符串”的错误。
Laravel的查询构建器是对象方法链式调用的设计，没有任何“把方法链拼成字符串再和对象拼接”的运行逻辑。

核心调整方向：

• 放弃字符串拼接方法链的思路，直接在循环中对查询实例调用对应方法
• 对多组OR关联的范围条件做闭包分组，避免和查询中其他条件的逻辑优先级错乱
• 增加基础参数校验，防止异常入参引发SQL错误

对应作用域代码：

public function scopePlz($query, $plz)
{
    // 空入参直接返回原查询，不做额外筛选
    if (empty($plz)) {
        return $query;
    }

    // 闭包包裹多OR条件，保证筛选逻辑优先级正确
    $query->where(function ($subQuery) use ($plz) {
        foreach ($plz as $index => $singleRange) {
            // 跳过参数不完整的无效区间
            if (count($singleRange) < 2) {
                continue;
            }
            [$start, $end] = $singleRange;
            if ($index === 0) {
                $subQuery->whereBetween('postalcode_int', [$start, $end]);
            } else {
                $subQuery->orWhereBetween('postalcode_int', [$start, $end]);
            }
        }
    });

    return $query;
}

• 多组OR范围查询如果不做闭包分组，最终生成的SQL逻辑会变成「原有筛选条件 且 范围1 或 范围2 或 范围3」，完全偏离业务预期，正确的分组后逻辑是「原有筛选条件 且 （范围1 或 范围2 或 范围3）」
• 所有针对查询构建器的操作，都必须直接调用对象方法完成，不要尝试通过字符串拼接的方式模拟方法链
• 传入的邮编区间数组如果存在参数缺失的情况，一定要做校验，避免SQL执行报错

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