Laravel查询构造器addSelect后where过滤自定义别名列触发1054未知列错误

这个报错是两个机制共同作用导致的：

• MySQL查询执行顺序的限制
  MySQL的子句执行优先级为：FROM/JOIN → WHERE → GROUP BY → HAVING → SELECT → ORDER BY → LIMIT。你通过addSelect定义的worksheets_count是通过关联子查询计算出来的派生字段，并非partners表的物理列。而WHERE子句的执行时机远早于SELECT阶段的派生字段计算，此时数据库根本无法识别worksheets_count这个别名，自然会抛出“未知列”的错误。
• Laravel分页的count查询特性
  Laravel的paginate方法会自动生成一个独立的聚合查询，用来计算符合条件的总分页记录数。这个生成的count查询会默认清空自定义的SELECT字段、别名计算逻辑，只保留表原生的过滤条件。这也是为什么报错信息里的SQL是select count(*) as aggregate from partners where worksheets_count > 0——生成的count查询完全没有带上你自定义的worksheets_count子查询计算逻辑，直接把这个不存在的别名当成了物理列去匹配。

当你移除针对worksheets_count的WHERE条件时，查询既不会在WHERE阶段尝试匹配不存在的派生列，分页生成的count查询也不会收到这个非法过滤条件，因此可以正常执行。

方案1：用HAVING子句替代WHERE过滤派生字段 #

HAVING的执行顺序在SELECT阶段之后，可以正常识别SELECT中定义的派生别名。只需要将原有的where('worksheets_count', '>', 0)替换为having('worksheets_count', '>', 0)即可：

return Partner::select('*')->addSelect(['worksheets_count' => $worksheets])
            ->having('worksheets_count', '>', 0)
            ->paginate(20)
            ->map(function($item) {
                return [
                    'partner_id' => $item->id,
                    'partner_name' => $item->name,
                    'partner_address' => $item->address(),
                    'worksheets_count' => $item->worksheets_count,
                ];
            })->toArray();

Laravel新版本生成分页count查询时，会自动保留HAVING子句的过滤逻辑，不需要额外手动修改count查询的生成规则。

方案2：转化为存在性判断（性能最优） #

你当前的过滤逻辑本质是“筛选出至少存在1条符合条件的关联工单的合作伙伴”，完全不需要先计算总数量再过滤。可以直接通过whereExists实现存在性判断，所有过滤条件都在WHERE阶段执行，彻底规避派生字段的识别问题，同时减少数据库的扫描开销：

return Partner::select('*')->addSelect(['worksheets_count' => $worksheets])
            // 直接判断存在符合条件的关联工单，替代原有的count>0过滤
            ->whereExists(function($query) {
                $query->select(DB::raw(1))
                      ->from('worksheets')
                      ->withoutGlobalScopes()
                      ->whereColumn('worksheets.partner_id', 'partners.id')
                      ->whereHas('tireServiceItems', function($q) {
                          $q->where('service_type', 'like', 'szerelés%')
                            ->orWhere('service_type', 'like', 'javítás%');
                      })
                      ->where('service_date', '>=', $from)
                      ->where('service_date', '<=', $to)
                      ->when($partnerId, function($q) use ($partnerId) {
                          $q->where('partner_id', $partnerId);
                      })
                      ->whereNull('worksheets.deleted_at');
            })
            ->paginate(20)
            ->map(function($item) {
                return [
                    'partner_id' => $item->id,
                    'partner_name' => $item->name,
                    'partner_address' => $item->address(),
                    'worksheets_count' => $item->worksheets_count,
                ];
            })->toArray();

这种写法下，数据库只要匹配到一条符合条件的关联记录就会停止扫描，比先计算全量count再过滤的执行效率高很多。

方案3：原生WHERE子查询判断 #

如果必须在WHERE阶段完成过滤，也可以把原有的count子查询逻辑直接写在WHERE条件中，不依赖字段别名：

->whereRaw("(
    SELECT COUNT(*) 
    FROM worksheets 
    WHERE worksheets.partner_id = partners.id 
    AND /* 这里完整复制原$worksheets子查询的所有where条件 */
) > 0")

这种写法的缺点是相同的过滤逻辑需要写两次（一次在addSelect里计算count值，一次在whereRaw里做过滤判断），后期维护容易出现逻辑不一致的问题。

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