Laravel 8中where结合orWhere fallback逻辑未按预期生效

我正在开发一个Laravel 8项目，需对Brand模型进行查询。Brand与多个Affiliate模型关联，且同一Brand下仅存在一个is_default为true的Affiliate。

需求：优先根据请求的affiliate参数返回对应单个Affiliate；若未找到则回退查询is_default为true的Affiliate；若都不存在则返回null。

我编写的查询代码如下：

$brand = Brand::where('slug', $request->input('slug'))
                ->where('uuid', $request->input('uuid'))
                ->with([
                'latest_affiliate' => function ($query) use ($request) {
                    $query->where('affiliate', $request->input('affiliate', null))
                            ->orWhere('is_default', true);
                }
                ])
                ->first();

因latest_affiliate关联仅返回一条数据，我原以为逻辑可行，但当发送不存在指定affiliate但存在默认Affiliate的请求时，返回的affiliate字段为null。请问我忽略了什么问题？

相关关联定义代码：

/**
 * Get the affiliates for the brand.
 */
public function affiliates()
{
    return $this->hasMany(Affiliate::class);
}

/**
 * Get the latest affiliate of many
 */
public function latest_affiliate()
{
    return $this->hasOne(Affiliate::class)->latestOfMany();
}

核心问题 #

你当前的查询逻辑没有实现「优先返回指定affiliate，不存在则返回默认」的优先级规则，而是将两个条件平等对待，取符合任一条件的最新记录。这会导致两种关键问题：

1. 如果指定的affiliate存在但不是最新的，会被更新的默认affiliate覆盖，不符合需求；
2. 当指定affiliate不存在时，若存在其他符合OR条件的记录（比如affiliate字段为null的旧记录），会优先返回这些记录而非默认的，极端情况下可能因筛选后无符合排序逻辑的记录返回null。

另外，latest_affiliate关联的latestOfMany()会强制按「最新」排序，进一步干扰了你的优先级规则。

解决方案 #

方案一：手动分优先级查询（最直观，完全匹配需求逻辑）

先尝试获取指定的affiliate，不存在则 fallback 到默认的，最后手动绑定到Brand模型的关联上：

$brand = Brand::where('slug', $request->input('slug'))
                ->where('uuid', $request->input('uuid'))
                ->first();

if ($brand) {
    // 优先查找指定affiliate
    $targetAffiliate = $brand->affiliates()
        ->where('affiliate', $request->input('affiliate'))
        ->first();

    // 未找到则查找默认affiliate
    if (!$targetAffiliate) {
        $targetAffiliate = $brand->affiliates()
            ->where('is_default', true)
            ->first();
    }

    // 将结果绑定到关联字段
    $brand->setRelation('latest_affiliate', $targetAffiliate);
}

方案二：通过排序强制优先级（单查询实现）

在关联查询中通过orderByRaw给指定affiliate最高优先级，再取第一条：

$brand = Brand::where('slug', $request->input('slug'))
                ->where('uuid', $request->input('uuid'))
                ->with([
                    'latest_affiliate' => function ($query) use ($request) {
                        $affiliateParam = $request->input('affiliate');
                        $query->where(function ($q) use ($affiliateParam) {
                            $q->where('affiliate', $affiliateParam)
                              ->orWhere('is_default', true);
                        })
                        // 让指定affiliate排在最前面，优先级最高
                        ->orderByRaw("CASE WHEN affiliate = ? THEN 0 ELSE 1 END", [$affiliateParam])
                        ->latest()
                        ->limit(1);
                    }
                ])
                ->first();

补充优化 #

如果要保留latest_affiliate关联的原有逻辑，建议新增一个专门用于该需求的关联：

public function preferred_affiliate($affiliateParam = null)
{
    return $this->hasOne(Affiliate::class)
        ->where(function ($q) use ($affiliateParam) {
            $q->where('affiliate', $affiliateParam)
              ->orWhere('is_default', true);
        })
        ->orderByRaw("CASE WHEN affiliate = ? THEN 0 ELSE 1 END", [$affiliateParam])
        ->latest();
}

查询时使用这个关联：

$brand = Brand::where('slug', $request->input('slug'))
                ->where('uuid', $request->input('uuid'))
                ->with(['preferred_affiliate' => fn($q) => $q->setBindings([$request->input('affiliate')])])
                ->first();

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